summaryrefslogtreecommitdiff
path: root/ext/spl/examples/recursivedualiterator.inc
blob: 702e0cd745411414188d114e1a6cd37bc49aafbe (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 iterators
	 *
	 * @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();
	}
}

?>