- md5
- 16f5913356886e3d7b37071a7333f0d2
- sha1
- 556758d9568650ac3a25937977c923ffc323d5bd
- sha256
- 96266cf97a42e8fb1924e7d299797748a41d6c4e51b437a21e61c94b49d430cc
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159
<?php
/**
* Joomla! Content Management System
*
* @copyright Copyright (C) 2005 - 2020 Open Source Matters, Inc. All rights reserved.
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Tree;
\defined('JPATH_PLATFORM') or die;
/**
* Defines the trait for an Immutable Node Class.
*
* @since 4.0.0
*/
trait ImmutableNodeTrait
{
/**
* Parent node object
*
* @var NodeInterface
* @since 1.6
*/
protected $_parent = null;
/**
* Array of Children
*
* @var NodeInterface[]
* @since 1.6
*/
protected $_children = array();
/**
* Node left of this one
*
* @var NodeInterface
* @since 1.6
*/
protected $_leftSibling = null;
/**
* Node right of this one
*
* @var NodeInterface
* @since 1.6
*/
protected $_rightSibling = null;
/**
* Get the children of this node
*
* @param boolean $recursive False by default
*
* @return NodeInterface[] The children
*
* @since 4.0.0
*/
public function &getChildren($recursive = false)
{
if ($recursive)
{
$items = array();
foreach ($this->_children as $child)
{
$items[] = $child;
$items = array_merge($items, $child->getChildren(true));
}
return $items;
}
return $this->_children;
}
/**
* Get the parent of this node
*
* @return NodeInterface|null
*
* @since 4.0.0
*/
public function getParent()
{
return $this->_parent;
}
/**
* Get the root of the tree
*
* @return ImmutableNodeInterface
*
* @since 4.0.0
*/
public function getRoot()
{
$root = $this->getParent();
if (!$root)
{
return $this;
}
while ($root->hasParent())
{
$root = $root->getParent();
}
return $root;
}
/**
* Test if this node has children
*
* @return boolean True if there is a child
*
* @since 4.0.0
*/
public function hasChildren()
{
return (bool) \count($this->_children);
}
/**
* Test if this node has a parent
*
* @return boolean True if there is a parent
*
* @since 4.0.0
*/
public function hasParent()
{
return $this->getParent() != null;
}
/**
* Returns the right or left sibling of a node
*
* @param boolean $right If set to false, returns the left sibling
*
* @return NodeInterface|null NodeInterface object of the sibling.
*
* @since 4.0.0
*/
public function getSibling($right = true)
{
if ($right)
{
return $this->_rightSibling;
}
else
{
return $this->_leftSibling;
}
}
}
The same content is in 5 releases, Joomla 4.0.0-beta to 4.0.0-beta5. See them all, or every version of this file.