- md5
- d8029e4a1dada3a1ae63a2fff060b29c
- sha1
- b42f58f04eb9cfe057af57462d8f2eb51ac1d51a
- sha256
- 48469ca89ac52ecbdce87a0072e22cf03d630879fec2057155ba43ba21a2a176
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155
<?php
/**
* Joomla! Content Management System
*
* @copyright (C) 2019 Open Source Matters, Inc. <https://www.joomla.org>
* @license GNU General Public License version 2 or later; see LICENSE.txt
*/
namespace Joomla\CMS\Tree;
// phpcs:disable PSR1.Files.SideEffects
\defined('JPATH_PLATFORM') or die;
// phpcs:enable PSR1.Files.SideEffects
/**
* 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 = [];
/**
* 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 = [];
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 53 releases, Joomla 4.3.0-beta1 to 4.4.14. See them all, or every version of this file.