Finds hierarchy loops using a callback function that maps object IDs to parent IDs.

$callback callable Required

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

$start int Required

The ID to start the loop check at.

$start_parent int Required

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

$callback_args array Optional

Additional arguments to send to $callback.

Default: array()

array IDs of all members of loop.

File: wp-includes/functions.php. View all references

function wp_find_hierarchy_loop( $callback, $start, $start_parent, $callback_args = array() ) {
	$override = is_null( $start_parent ) ? array() : array( $start => $start_parent );

	$arbitrary_loop_member = wp_find_hierarchy_loop_tortoise_hare( $callback, $start, $override, $callback_args );
	if ( ! $arbitrary_loop_member ) {
		return array();
	}

	return wp_find_hierarchy_loop_tortoise_hare( $callback, $arbitrary_loop_member, $override, $callback_args, true );
}