ContextMatcher.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
namespace ILIAS\UI\Implementation\Render;
 
class ContextMatcher
{
    public function isDirectDescendantOfAny(array $context_asc, array $search_any): bool
    {
        // ensure minimum context size allowing direct descendants
        $context_size = count($context_asc);
        if (2 > $context_size) {
            return false;
        }
        return in_array($context_asc[$context_size - 2], $search_any, true);
    }
 
    public function isDirectDescendantOf(array $context_asc, array $search_exactly): bool
    {
        // ensure minimum context size allowing direct descendants
        $search_size = count($search_exactly);
        if (0 === $search_size || $search_size + 1 > count($context_asc)) {
            return false;
        }
        $ancestors = array_slice($context_asc, 0, -1);
        return $search_exactly === array_slice($ancestors, -$search_size);
    }
 
    public function isIndirectDescendantOfAny(array $context_asc, array $search_any): bool
    {
        // ensure minimum context size allowing direct descendants
        if (3 > count($context_asc)) {
            return false;
        }
        $indirect_ancestors = array_slice($context_asc, 0, -2);
        return [] !== array_intersect($indirect_ancestors, $search_any);
    }
 
    public function isIndirectDescendantOf(array $context_asc, array $search_exactly): bool
    {
        // ensure minimum context size allowing direct descendants
        $search_size = count($search_exactly);
        if (0 === $search_size || $search_size + 2 > count($context_asc)) {
            return false;
        }
        $indirect_ancestors = array_slice($context_asc, 0, -2);
        $last_start = count($indirect_ancestors) - $search_size;
        for ($start = 0; $last_start >= $start; $start++) {
            if ($search_exactly === array_slice($indirect_ancestors, $start, $search_size)) {
                return true;
            }
        }
        return false;
    }
 
    public function isDescendantOfAny(array $context_asc, array $search_any): bool
    {
        return $this->isDirectDescendantOfAny($context_asc, $search_any)
            || $this->isIndirectDescendantOfAny($context_asc, $search_any);
    }
 
    public function isDescendantOf(array $context_asc, array $search_exactly): bool
    {
        return $this->isDirectDescendantOf($context_asc, $search_exactly)
            || $this->isIndirectDescendantOf($context_asc, $search_exactly);
    }
}