Download the PHP package wmde/traversable-iterator without Composer
On this page you can find all versions of the php package wmde/traversable-iterator. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download wmde/traversable-iterator
More information about wmde/traversable-iterator
Files in wmde/traversable-iterator
Package traversable-iterator
Short Description Turn Traversable objects into Iterators. Fixed version of the native IteratorIterator
License GPL-2.0+
Homepage https://github.com/wmde/traversable-iterator
Informations about the package traversable-iterator
Traversable Iterator
Iterator
that can be constructed from Traversable
objects.
Can be seen as a fixed version of IteratorIterator
(which is used internally). IteratorIterator
behaves in unexpected ways when constructed from an IteratorAggregate
: it only calls getIterator
once rather than once per iteration, which is what happens when you traverse the IteratorAggregate
directly. In other words: looping over an IteratorIterator
that contains a IteratorAggregate
yields
different behaviour than looping over the IteratorAggregate
itself. This is unexpected and can be
problematic. For instance when the IteratorAggregate
contains a Generator
(which happens often),
looping over the IteratorIterator
more than once will cause an error due to the Generator
not
being rewindable.
Example of how IteratorIterator
fails:
This exception, and more generally difference in behaviour, does not occur when using TraversableIterator
.
Installation
To add this package as a local, per-project dependency to your project, simply add a
dependency on wmde/traversable-iterator
to your project's composer.json
file.
Here is a minimal example of a composer.json
file that just defines a dependency on
Traversable Iterator 1.x:
Usage
Running the tests
For a full CI run
composer ci
For tests only
composer test
For style checks only
composer cs
Release notes
1.0.0 (2017-06-17)
- Initial release