xref: /PHP-5.3/ext/spl/examples/searchiterator.inc (revision 1b9e0de2)
1<?php
2
3/** @file searchiterator.inc
4 * @ingroup Examples
5 * @brief abstract class SearchIterator
6 * @author  Marcus Boerger
7 * @date    2003 - 2005
8 *
9 * SPL - Standard PHP Library
10 */
11
12/** @ingroup Examples
13 * @brief Iterator to search for a specific element
14 * @author  Marcus Boerger
15 * @version 1.0
16 *
17 * This extended FilterIterator stops after finding the first acceptable
18 * value.
19 */
20abstract class SearchIterator extends FilterIterator
21{
22	/** @internal whether an entry was found already */
23	private $done = false;
24
25	/** Rewind and reset so that it once again searches.
26	 * @return void
27	 */
28	function rewind()
29	{
30		parent::rewind();
31		$this->done = false;
32	}
33
34	/** @return whether the current element is valid
35	 * which can only happen once per iteration.
36	 */
37	function valid()
38	{
39		return !$this->done && parent::valid();
40	}
41
42	/** Do not move forward but instead mark as finished.
43	 * @return void
44	 */
45	function next()
46	{
47		$this->done = true;
48	}
49
50	/** Aggregates the inner iterator
51	 */
52	function __call($func, $params)
53	{
54		return call_user_func_array(array($this->getInnerIterator(), $func), $params);
55	}
56}
57
58?>