summaryrefslogtreecommitdiff
path: root/ext/spl/tests/recursivedualiterator.inc
blob: 45abf4c8f45568a1b3188cf0716f33e11d1a2638 (plain)
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 whether both LHS and RHS have children
     */
    function hasChildren()
    {
        return $this->getLHS()->hasChildren() && $this->getRHS()->hasChildren();
    }

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

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

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

?>