Documentation

// $henry が属するツリーのルートを取得
$root = $henry->root()->get_one();

// 'true' を echo
echo $root == $bill ? 'true' : 'false';

// 特定のツリーのルートを取得
$root = Model_Tree::forge()->set_tree_id($mytreeid)->root()->get_one();

// ツリー内のすべてのルートを取得
$roots = $henry->roots()->get();

// 'true' を echo （このツリー内には 1 つのルートだけがある）
echo reset($roots) == $bill ? 'true' : 'false';

// 既存のオブジェクトを起点とせずにすべてのルートを取得
$roots = Model_Tree::forge()->roots()->get();

// $nicola の親を取得
$parent = $nicola->parent()->get_one();

// 'true' を echo
echo $parent == $angela ? 'true' : 'false';

// null が返る。ノードのツリーコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->parent()->get_one();

// $angela の子を取得
$children = $angela->children()->get();

// 'true' を echo
echo $children == array($henry->id => $henry, $nicola->id => $nicola) ? 'true' : 'false';

// null が 返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->children()->get();

// $henry の先祖を取得
$ancestors = $henry->children()->get();

// 'true' を echo
echo $ancestors == array($bill->id => $bill, $angela->id => $angela) ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->ancestors()->get();

// $ben の子孫を取得
$descendants = $ben->descendants()->get();

// 'true' を echo
echo $descendants == array($kerry->id => $kerry, $tim->id => $tim, $james->id => $james) ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->descendants()->get();

// $ben の末端の子孫を取得
$descendants = $ben->leaf_descendants()->get();

// 'true' を echo。$kerry は子のオブジェクトを持つため、ここでは返されないことに注意
echo $descendants == array($tim->id => $tim, $james->id => $james) ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->leaf_descendants()->get();

// $kerry の兄弟を取得
$siblings = $kerry->siblings()->get();

// 'true' を echo
echo $siblings == array($kerry->id => $kerry, $james->id => $james) ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->siblings()->get();

// $bill の最初の子を取得
$child = $bill->first_child()->get_one();

// 'true' を echo
echo $child == $angela ? 'true' : 'false';

// null が 返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->first_child()->get_one();

// $bill の最後の子を取得
$child = $bill->last_child()->get_one();

// 'true' を echo
echo $child == $ben ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->last_child()->get_one();

// $nicola の前の兄弟を取得
$sibling = $nicola->previous_silbing()->get_one();

// 'true' を echo
echo $sibling == $henry ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->previous_sibling()->get_one();

// こちらも null が返る。$henry には前の兄弟がない
$sibling = $henry->previous_silbing()->get_one();

// $henry の次の兄弟を取得
$sibling = $henry->next_silbing()->get_one();

// 'true' を echo
echo $sibling == $nicola ? 'true' : 'false';

// null が返る。現在のノードのコンテキストがなければうまくいかない
$parent = Model_Tree::forge()->previous_sibling()->get_one();

// こちらも null が返る。$nicola には次の兄弟がない
$sibling = $nicola->next_silbing()->get_one();

// Tim までのパスを取得。"Bill/Ben/Kerry/Tim" を返す
$path = $tim->path()->get();

// Nicola までのパスを取得。"Bill/Angela/Nicola" を返す
$path = $nicola->path()->get();

// Kerry までのパスを取得。ボスについては除外。"Ben/Kerry" を返す
$path = $kerry->path(false)->get();

// Bill に部下を与える。ツリー上では Angela の前
$john = Model_Tree::forge(array('name' => 'John'))->first_child($bill)->save();

// Kerry を Bill の部下に昇進させる
$kerry->first_child($bill)->save();

// Bill に新たな部下を与える。ツリー上では Ben の後
$john = Model_Tree::forge(array('name' => 'John'))->last_child($bill)->save();

// Kerry を Bill の部下に昇進させる
$kerry->last_child($bill)->save();

// Bill に新たな部下を与える。ツリー上では Angela の前
$john = Model_Tree::forge(array('name' => 'John'))->previous_sibling($angela)->save();

// James を Ben の部下、Tim の隣へ降格させる
$james->previous_sibling($tim)->save();

// Bill に新たな部下を与える。ツリー上では Angela の後
$john = Model_Tree::forge(array('name' => 'John'))->next_sibling($angela)->save();

// James を Ben の部下、Tim の隣へ降格させる
$james->next_sibling($tim)->save();

// Bill がルートノードか？ 'true' を echo
echo $bill->is_root() ? 'true' : 'false';

// Tim がルートノードか？ 'false' を echo
echo $tim->is_root() ? 'true' : 'false';

// Tim が末端ノードか？ 'true' を echo
echo $tim->is_leaf() ? 'true' : 'false';

// Angela が末端ノードか？ 'false' を echo
echo $angela->is_leaf() ? 'true' : 'false';

// Henry がルートノードか？ 'true' を echo
echo $henry->is_child() ? 'true' : 'false';

// Bill がルートノードか？ 'false' を echo
echo $bill->is_child() ? 'true' : 'false';

// Ben が Bill の子ノードか？ 'true' を echo
echo $ben->is_child_of($bill) ? 'true' : 'false';

// James が Bill の子ノードか？ 孫なので 'false' を echo
echo $james->is_child_of($bill) ? 'true' : 'false';

// Nicola が Ben の子ノードか？ ツリーの違う部分なので 'false' を echo
echo $nicola->is_child_of($ben) ? 'true' : 'false';

// Ben が Bill の子孫ノードか？ 'true' を echo
echo $ben->is_descendant_of($bill) ? 'true' : 'false';

// James が Bill の子孫ノードか？ 孫なので 'true' を echo
echo $james->is_descendant_of($bill) ? 'true' : 'false';

// Nicola が Ben の子孫ノードか？ ツリーの別の部分なので 'false' を echo
echo $nicola->is_descendant_of($ben) ? 'true' : 'false';

// Bill が Ben の親か？ 'true' を echo
echo $bill->is_parent_of($ben) ? 'true' : 'false';

// Bill が James の親か？ 祖父なので 'false' を echo
echo $bill->is_parent_of($james) ? 'true' : 'false';

// Bill が Ben の祖先か？ 'true' を echo
echo $bill->is_ancestor_of($ben) ? 'true' : 'false';

// Bill が James の祖先か？ 祖父なので 'true' を echo
echo $bill->is_ancestor_of($james) ? 'true' : 'false';

// James が前の兄弟を持つか？ 'true' を echo
echo $james->has_previous_sibling() ? 'true' : 'false';

// Tim が前の兄弟を持つか？ 'false' を echo
echo $tim->has_previous_sibling() ? 'true' : 'false';

// Henry が次の兄弟を持つか？ 'true' を echo
echo $henry->has_next_sibling() ? 'true' : 'false';

// Ben が次の兄弟を持つか？ 'false' を echo
echo $ben->has_next_sibling() ? 'true' : 'false';

// ツリー ID のカラム名を取得
$tree_id = Model_Tree::tree_config('tree_id');

// tree_id を取得する（1 を返す）
$current_tree = $bill->get_tree_id();

// あるツリーのルートを既存のノードを起点とせずに取得する
$root = Model_Tree::forge()->set_tree_id($mytreeid)->get_one();

// 現在のツリー内で enabled がセットされたすべてのノードを取得する
$enabled = Model_Tree::forge()
	->set_tree_id($mytreeid)
	->build_query()
	->where('enabled', '=', 1)
	->get();

// 既存のオブジェクトを使う場合。$bill のオブジェクトのツリー ID が使われる
$enabled = $bill
	->build_query()
	->where('enabled', '=', 1)
	->get();

// Bill の enabled がセットされたすべての子ノードを取得する
$enabled = $bill
	->children()
	->get_query()
	->where('enabled', '=', 1)
	->get();

// Bill の子の数を取得。2 を echo
echo $bill->count_children();

// Kerry の子の数を取得。1 を echo
echo $kerry->count_children();

// Tim の子の数を取得。0 を echo
echo $tim->count_children();

// これも 0 を echo。新たなオブジェクトは子を持たない
echo Model_Tree::forge()->count_children();

// Bill の子孫の数を取得。7 を echo
echo $bill->count_descendants();

// Ben の子の数を取得。3 を echo
echo $ben->count_descendants();

// 0 を echo。新たなオブジェクトは子孫を持たない
echo Model_Tree::forge()->count_descendants();

// 組織内での Bill の階級を取得
echo $bill->depth(); // 0 を echo。彼が親分だ！

// 組織内での Angela の階級を取得
echo $angela->depth(); // 1 を echo。彼女は N+1 のため

// 組織内での Tim の階級を取得
echo $tim->depth(); // 3 を echo。いちばんの下っ端だ……

// 偽を返す。新たなノードの階層を取得することはできない
$result = Model_Tree::forge()->depth();

// 多次元配列を返す。$tree['children'] が Bill の子を持つ
$tree = $bill->dump_tree();

// 'children' プロパティとして Bill の子を持つ 'bill' オブジェクトを返す
$tree = $bill->dump_tree(true);

// $tree を使うと、array($angela, $ben) を返す
$children = $tree->children;

// そしてこちらは array($henry, $nicola)、つまり $angela の子を返す
$grandchildren = reset($children)->children;

// ORM オブジェクトは常に参照として扱われる！
$bill->dump_tree(true);

// ので、こっちでもいける
$children = $bill->children;

// リレーション 'child' のオブジェクトを結果に含める
$tree = $bill->related('child')->dump_tree();

// $ben の子孫を取得
$descendants = $ben->descendants()->related('child')->get();

// これには child のリレーションは含まれ「ない」！
$descendants = $ben->related('child')->descendants()->get();