wmde/iterable-functions

Functions to transform iterables into more specific types

Iterable Functions

, _(*1)

Provides basic functions to work with variables for type iterable (added in PHP 7.1). Primarily to transform variables of type iteratble into more specific types such as array., _(*2)

If you have an iterable somewhere and you need to pass it to a function that only takes an array or an Iterator, you have a problem. You will need to add conditional logic to find out the type of the value and transform it if needed, which gets quite involved in the case of needing an Iterator., _(*3)

This problem is quite common, as PHP's standard library, as of version 7.1, tends to either require arrays, iterators or traversables., _(*4)

Example:, _(*5)

function doStuff(iterable $iterable) {
    $iterableMinusFooBar = array_diff( $iterable, [ 'foo', 'bar' ] );
}
// Output: array_diff(): Argument #1 is not an array

Installation

To add this package as a local, per-project dependency to your project, simply add a dependency on wmde/iterable-functions to your project's composer.json file. Here is a minimal example of a composer.json file that just defines a dependency on Iterable Functions 1.x:, _(*6)

{
    "require": {
        "wmde/iterable-functions": "~1.0"
    }
}

Usage

When you need an array, _(*7)

function doStuff(iterable $iterable) {
    $iterableMinusFooBar = array_diff( iterable_to_array( $iterable ), [ 'foo', 'bar' ] );
}

When you need an Iterator, _(*8)

function doStuff(iterable $iterable) {
    $firstFewThings = new LimitIterator( iterable_to_iterator( $iterable ), 42 );
}

Running the tests

For a full CI run, _(*9)

composer ci

For tests only, _(*10)

composer test

For style checks only, _(*11)

composer cs

Release notes

0.2.0 (2018-09-13)

• Added iterable_merge

0.1.0 (2017-06-17)

Initial release with, _(*12)

• iterable_to_array
• iterable_to_iterator