File: recursivedualiterator.inc

package info (click to toggle)
php8.4 8.4.11-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 208,108 kB
  • sloc: ansic: 1,060,628; php: 35,345; sh: 11,866; cpp: 7,201; pascal: 4,913; javascript: 3,091; asm: 2,810; yacc: 2,411; makefile: 689; xml: 446; python: 301; awk: 148
file content (72 lines) | stat: -rw-r--r-- 2,102 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
<?php

/** @file recursivedualiterator.inc
 * @ingroup Examples
 * @brief class RecursiveDualIterator
 * @author  Marcus Boerger
 * @date    2003 - 2006
 *
 * SPL - Standard PHP Library
 */

/** @ingroup Examples
 * @brief   Synchronous iteration over two recursive iterators
 * @author  Marcus Boerger
 * @version 1.0
 */
class RecursiveDualIterator extends DualIterator implements RecursiveIterator
{
    private $ref;

    /** construct iterator from two RecursiveIterator instances
     *
     * @param lhs   Left  Hand Side Iterator
     * @param rhs   Right Hand Side Iterator
     * @param flags iteration flags
     */
    function __construct(RecursiveIterator $lhs, RecursiveIterator $rhs,
                $flags = 0x33 /*DualIterator::DEFAULT_FLAGS*/)
    {
        parent::__construct($lhs, $rhs, $flags);
    }

    /** @return bool whether both LHS and RHS have children
     */
    function hasChildren(): bool
    {
        return $this->getLHS()->hasChildren() && $this->getRHS()->hasChildren();
    }

    /** @return RecursiveDualIterator (late binding) for the two inner
     * iterators current children.
     */
    function getChildren(): RecursiveDualIterator
    {
        if (empty($this->ref))
        {
            $this->ref = new ReflectionClass($this);
        }
        return $this->ref->newInstance(
                    $this->getLHS()->getChildren(), $this->getRHS()->getChildren(), $this->getFlags());
    }

    /** @return bool whether both inner iterators are valid, have same hasChildren()
     * state and identical current and key values or both are non valid.
     */
    function areIdentical(): bool
    {
        return $this->getLHS()->hasChildren() === $this->getRHS()->hasChildren()
            && parent::areIdentical();
    }

    /** @return bool whether both inner iterators are valid, have same hasChildren()
     * state and equal current and key values or both are invalid.
     */
    function areEqual(): bool
    {
        return $this->getLHS()->hasChildren() === $this->getRHS()->hasChildren()
            && parent::areEqual();
    }
}

?>