wp_find_hierarchy_loop( callable $callback, int $start, int $start_parent, array $callback_args = array() ): array

Parameters

$callbackcallable

Function that accepts ( ID, $callback_args ) and outputs parent_ID.

$startint

The ID to start the loop check at.

$start_parentint

The parent_ID of $start to use instead of calling $callback( $start ). Use null to always use $callback.

$callback_argsarrayoptional

Additional arguments to send to $callback. Default empty array.Default: array()

Return

array

IDs of all members of loop.

Uses · 1

• wp_find_hierarchy_loop_tortoise_hare()Uses the "The Tortoise and the Hare" algorithm to detect loops.

Used by · 2

• wp_check_post_hierarchy_for_loops()Checks the given subset of the post hierarchy for hierarchy loops.
• wp_check_term_hierarchy_for_loops()Checks the given subset of the term hierarchy for hierarchy loops.

Source

View on Trac ↗View on GitHub ↗

7073function wp_find_hierarchy_loop( $callback, $start, $start_parent, $callback_args = array() ) {7074	$override = is_null( $start_parent ) ? array() : array( $start => $start_parent );7075 7076	$arbitrary_loop_member = wp_find_hierarchy_loop_tortoise_hare( $callback, $start, $override, $callback_args );7077	if ( ! $arbitrary_loop_member ) {7078		return array();7079	}7080 7081	return wp_find_hierarchy_loop_tortoise_hare( $callback, $arbitrary_loop_member, $override, $callback_args, true );7082}

History

Introduced in 3.1.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.8.8 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.