parents.php

См. документацию.

<?php
 
namespace Bitrix\Location\Entity\Location;
 
use Bitrix\Location\Entity\Location;

final class Parents extends Collection
{
    protected $items = [];
    protected $descendant;

    public function getDescendant(): ?Location
    {
        return $this->descendant;
    }

    public function setDescendant(Location $descendant): self
    {
        $this->descendant = $descendant;
        return $this;
    }

    public function isContain(Location $location): bool
    {
        foreach($this->items as $item)
        {
            if($item->isEqualTo($location))
            {
                return true;
            }
        }
 
        return false;
    }

    public function isEqualTo(Parents $parents): bool
    {
        if($this->count() !== $parents->count())
        {
            return false;
        }

        foreach($this as $idx => $item)
        {
            if(!$item->isEqualTo($parents[$idx]))
            {
                return false;
            }
        }
 
        return true;
    }

    public function getItemByType(int $type):? Location
    {
        foreach($this->items as $item)
        {
            if($item->getType() === $type)
            {
                return $item;
            }
        }
 
        return null;
    }
}