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
|
<?php
/** @file searchiterator.inc
* @ingroup Examples
* @brief abstract class SearchIterator
* @author Marcus Boerger
* @date 2003 - 2005
*
* SPL - Standard PHP Library
*/
/** @ingroup Examples
* @brief Iterator to search for a specific element
* @author Marcus Boerger
* @version 1.0
*
* This extended FilterIterator stops after finding the first acceptable
* value.
*/
abstract class SearchIterator extends FilterIterator
{
/** @internal whether an entry was found already */
private $done = false;
/** Rewind and reset so that it once again searches.
* @return void
*/
function rewind()
{
parent::rewind();
$this->done = false;
}
/** @return whether the current element is valid
* which can only happen once per iteration.
*/
function valid()
{
return !$this->done && parent::valid();
}
/** Do not move forward but instead mark as finished.
* @return void
*/
function next()
{
$this->done = true;
}
/** Aggregates the inner iterator
*/
function __call($func, $params)
{
return call_user_func_array(array($this->getInnerIterator(), $func), $params);
}
}
?>
|