get_page_hierarchy( WP_Post[] $pages, int $page_id )

在一个简单的列表中为父母以下的孩子排序。
Order the pages with children under parents in a flat list.

目录锚点：#说明#参数#返回#源码#笔记

---

说明（Description）

它使用辅助结构来保持父子关系，并以O（N）复杂度运行

参数（Parameters）

返回（Return）

（string[]）按ID键控并按层次结构排列的帖子名称数组。孩子们立即跟随父母。

源码（Source）

/**
 * Order the pages with children under parents in a flat list.
 *
 * It uses auxiliary structure to hold parent-children relationships and
 * runs in O(N) complexity
 *
 * @since 2.0.0
 *
 * @param array $pages   Posts array, passed by reference.
 * @param int   $page_id Optional. Parent page ID. Default 0.
 * @return array A list arranged by hierarchy. Children immediately follow their parents.
 */
function get_page_hierarchy( &$pages, $page_id = 0 ) {
	if ( empty( $pages ) ) {
		return array();
	}

	$children = array();
	foreach ( (array) $pages as $p ) {
		$parent_id = intval( $p->post_parent );
		$children[ $parent_id ][] = $p;
	}

	$result = array();
	_page_traverse_name( $page_id, $children, $result );

	return $result;
}

笔记（Notes）

get_page_hierarchy（）返回一个ID=>page_title数组：键是页的ID，值是页的标题。