diff options
Diffstat (limited to 'ext/spl/spl.php')
| -rwxr-xr-x | ext/spl/spl.php | 202 |
1 files changed, 0 insertions, 202 deletions
diff --git a/ext/spl/spl.php b/ext/spl/spl.php index a37036ff72..9d1f013376 100755 --- a/ext/spl/spl.php +++ b/ext/spl/spl.php @@ -401,57 +401,6 @@ interface Iterator extends Traversable } /** @ingroup SPL - * @brief Recursive iterator - * - * Interface for recursive traversal to be used with - * RecursiveIteratorIterator. - */ -interface RecursiveIterator extends Iterator -{ - /** @return whether current element can be iterated itself. - */ - function hasChildren(); - - /** @return an object that recursively iterates the current element. - * This object must implement RecursiveIterator. - */ - function getChildren(); -} - -/** @ingroup SPL - * @brief Class for recursive traversal. - * - * The objects of this class are created by instances of RecursiveIterator. - * Elements of those iterators may be traversable themselves. If so these - * sub elements are recursed into. - */ -class RecursiveIteratorIterator implements Iterator -{ - /** Construct an instance form a RecursiveIterator. - * - * @param $iterator inner root iterator - * @param $mode one of - * - RIT_LEAVES_ONLY do not return elements that can be recursed. - * - RIT_SELF_FIRST show elements before their sub elements. - * - RIT_CHILD_FIRST show elements after their sub elements. - * - * @note If you want to see only those elements which have sub elements then - * use a ParentIterator. - */ - function __construct(RecursiveIterator $iterator, $mode); - - /** @return the level of recursion (>=0). - */ - function getDepth(); - - /** @param $level the level of the sub iterator to return. - * @return the current inner sub iterator or the iterator at the - * specified $level. - */ - function getSubIterator([$level]); -} - -/** @ingroup SPL * @brief This Interface allows to hook into the global count() function. */ interface Countable @@ -462,21 +411,6 @@ interface Countable } /** @ingroup SPL - * @brief Seekable iterator - * - * This interface is used to optimize LimitIterator functionality. but it - * may also be used for other situations where seeking a specific offset is - * required and easily possible. - */ -interface SeekableIterator extends Iterator -{ - /** Seek to a specific position if available or throw an exception. - * @param $position offset to seek to. - */ - function seek($position); -} - -/** @ingroup SPL * @brief An Array wrapper * * This array wrapper allows to recursively iterate over Arrays and public @@ -597,142 +531,6 @@ class ArrayIterator implements SeekableIterator, ArrayAccess, Countable } /** @ingroup SPL - * @brief An iterator that filters other iterators - * - * Iterator that wrapps around another iterator and only returns selected - * elements of the inner iterator. The only thing that needs to be done to - * make this work is implementing method accept(). Typically this invloves - * reading the current element or key of the inner Iterator and checking - * whether it is acceptable. - */ -abstract class FilterIterator implements Iterator -{ - /** Construct an instance form a Iterator. - * - * @param $iterator inner iterator - */ - function __construct(Iterator $iterator); - - /** @return whether the current element of the inner iterator should be - * used as a current element of this iterator or if it should be skipped. - */ - abstract function accept(); - - /** @return the inner Iterator - */ - function getInnerIterator(); -} - -/** @ingroup SPL - * @brief Limiting iterator - * - * A class that starts iteration at a certain offset and only iterates over - * a specified amount of elements. - * - * This class uses SeekableIterator::seek() if available and rewind() plus - * a skip loop otehrwise. - */ -class LimitIterator implements Iterator -{ - /** Construct an instance form a Iterator. - * - * @param $iterator inner iterator - * @param $offset starting position (zero based) - * @param $count amount of elements returned, if available) - */ - function __construct(Iterator $iterator, $offset = 0, $count = -1); - - /** @return whether the current element of the inner iterator should be - * used as a current element of this iterator or if it should be skipped. - */ - abstract function accept(); - - /** @return the inner Iterator - */ - function getInnerIterator(); - - /** Seek to a specific position if available or throw an exception. - * If the inner iterator is an instance of SeekableIterator its seek() - * method will be used. Otherwise the iterator will be rewound if - * necessary and then manually advanced element by element. - * - * @param $position index to seek to. - */ - function seek($position); - - /** @return the current position (zero based) - */ - function getPosition(); -} - -/** @ingroup SPL - * @brief Iterator that shows only parents - * - * A recursive iterator that only returns elements that themselves can be - * trversed. - */ -class ParentIterator extends FilterIterator implements RecursiveIterator -{ - /** Construct an instance form a RecursiveIterator. - * - * @param $iterator inner iterator - */ - function __construct(RecursiveIterator $iterator); -} - -/** @ingroup SPL - * @brief Caching iterator - * - * This Iterator allways reads one ahead. That allows it to know whether - * more elements are available. - */ -class CachingIterator implements Iterator -{ - /** Construct an instance form a RecursiveIterator. - * - * @param $iterator inner iterator - * @param flags Bitmask: - * - CIT_CALL_TOSTRING whether to call __toString() for - * every element. This is optional since it is not - * always used nad takes an additional fcall. - */ - function __construct(Iterator $iterator, $flags = CIT_CALL_TOSTRING); - - /** @return whether the inner iterator is valid. That is this iterator - * is valid and has one more element. - */ - function valid(); - - /** @return The last value from the inner iterators __toString() or - * (string) conversion. The value is only fetched when the __constructor - * was called with $getStrVal = true. - */ - function __tostring(); - - /** @return the inner Iterator - */ - function getInnerIterator(); -} - -/** @ingroup SPL - * @brief The recursive version of the CachingIterator. - */ -class CachingRecursiveIterator extends CachingIterator implements RecursiveIterator -{ - /** Construct an instance form a RecursiveIterator. - * - * @param $iterator inner iterator - * @param $flags Bitmask: - * - CIT_CALL_TOSTRING whether to call __toString() for - * every element. This is optional since it is not - * always used nad takes an additional fcall. - * - CIT_CATCH_GET_CHILD whether to catch exceptions when - * trying to get childs) - */ - function __construct(RecursiveIterator $iterator, $flags = CIT_CALL_TOSTRING); -} - -/** @ingroup SPL * @brief Directory iterator */ class DirectoryIterator implements Iterator |