pcrov / iteratorstackiterator
Iterates over a stack of iterators, discarding them as they complete.
Installs: 14 864
Dependents: 0
Suggesters: 0
Security: 0
Stars: 2
Watchers: 1
Forks: 0
Open Issues: 0
Requires
- php: ^7.0
- php-ds/php-ds: ^1
Requires (Dev)
- phpunit/phpunit: ^5.2
This package is auto-updated.
Last update: 2024-11-21 21:29:59 UTC
README
Iterates over a stack of iterators, discarding them as they complete.
Requirements
PHP 7 with either the Ds extension or its polyfill. The php-ds polyfill will be installed automatically when IteratorStackIterator is installed via composer and only loaded if the Ds extension is not installed and enabled.
Installation
To install with composer:
composer require pcrov/iteratorstackiterator
Usage
This iterator implements OuterIterator
, adding push()
and pop()
methods to add and
remove inner iterators, respectively.
push()
will return the new size of the stack.
pop()
will return the iterator popped from the top.
The values returned from key()
and current()
will always be from the current position of the top iterator on the
stack.
next()
moves the cursor of the iterator at the top of the stack. If that iterator is no longer valid it is removed, as
are any others that have completed until a valid iterator is found or the stack is empty.
rewind()
will rewind all iterators left on the stack.
Example 1
$stack = new \pcrov\IteratorStackIterator(); $stack->push( new ArrayIterator([1, 2, 3]), new ArrayIterator([4, 5, 6]), new ArrayIterator([7, 8, 9]) ); foreach ($stack as $value) { echo $value; } // output: 789456123
Iterators can be added to the stack after iteration has already begun. They will not automatically be rewound when
added, so you should call rewind()
on them prior if needed.
Example 2
$stack = new \pcrov\IteratorStackIterator(); $stack->push( new ArrayIterator([1, 2, 3]), new ArrayIterator([4, 5, 6]) ); $stack->rewind(); while ($stack->valid()) { $value = $stack->current(); echo $value; $stack->next(); if ($value === 2) { $stack->push(new ArrayIterator([7, 8, 9])); } } // output: 456127893
Note that next()
is called prior to pushing a new iterator, otherwise when the stack ran back down that position would
be repeated (which in this case result would result in an infinite loop.)
If an inner iterator's cursor position is manipulated from outside the stack iterator the resulting behavior is undefined.