jeroen/rewindable-generator

Provides a simple adapter to make generators rewindable

Rewindable Generator

, _(*1)

Provides a simple adapter to make generators rewindable. Please beware that you can do the same by using PHPs native CachingIterator., _(*2)

Unfortunately, you cannot do this:, _(*3)

$generator = $myGeneratorFunction();
iterator_to_array($generator);
iterator_to_array($generator); // boom!

Or this:, _(*4)

$generator = $myGeneratorFunction();
$generator->next();
$generator->rewind(); // boom!

Both result in an Exception, as proven by the tests in tests/GeneratorTest.php. This library provides a simple class that takes a generator function (the function, not its return value) and adapts it to a rewindable Iterator., _(*5)

$generator = new RewindableGenerator($myGeneratorFunction);
iterator_to_array($generator);
iterator_to_array($generator); // works as expected
$generator->rewind(); // works as expected

Installation

To add this package as a local, per-project dependency to your project, simply add a dependency on jeroen/rewindable-generator to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on Rewindable Generator 1.x:, _(*6)

{
    "require": {
        "jeroen/rewindable-generator": "~1.0"
    }
}

Running the tests

For tests only, _(*7)

composer test

For style checks only, _(*8)

composer cs

For a full CI run, _(*9)

composer ci

Release notes

Version 1.2.0 (2017-05-16)

• Dropped PHP 5.x support

Version 1.1.1 (2015-11-08)

• Fixed HHVM compatibility. Maybe...

Version 1.1.0 (2015-11-08)

• Added onRewind function and second constructor parameter to RewindableGenerator

Version 1.0.0 (2015-11-08)

• Initial release - read blog post