bentools/flatten-iterator

Flattens Traversable or arrays into one iterator.

1.1 2022-11-11 06:02 UTC

This package is auto-updated.

Last update: 2024-10-11 09:55:57 UTC


README

Latest Stable Version License CI Workflow codecov Quality Score Total Downloads

FlattenIterator

Flattens arrays and / or traversables. Accepts any iterable composed of iterables.

PHP 7.1+

Usage

use BenTools\FlattenIterator\FlattenIterator;

require_once __DIR__ . '/vendor/autoload.php';

$cities = [
    [
        'london' => 'London',
        'paris' => 'Paris',
    ],
    new \ArrayIterator([
        'berlin' => 'Berlin',
        'bruxelles' => 'Bruxelles',
    ]),
    (function () {
        yield 'budapest' => 'Budapest';
        yield 'prague' => 'Prague';
    })(),
];

foreach (new FlattenIterator($cities) as $city) {
    var_dump($city);
}

Output:

string(6) "London"
string(5) "Paris"
string(6) "Berlin"
string(9) "Bruxelles"
string(8) "Budapest"
string(6) "Prague"

Array output and fluent interface

You can use the built-in function to generate your flattened data, and export them as an array:

use function BenTools\FlattenIterator\flatten;
print_r(flatten($cities)->asArray());

Output:

array(6) {
  [0]=>
  string(6) "London"
  [1]=>
  string(5) "Paris"
  [2]=>
  string(6) "Berlin"
  [3]=>
  string(9) "Bruxelles"
  [4]=>
  string(8) "Budapest"
  [5]=>
  string(6) "Prague"
}

Preserve Keys

Set $preserveKeys to true to preserve keys in your flattened data:

var_dump(flatten($cities, $preserveKeys = true)->asArray());

Output:

array(6) {
  ["london"]=>
  string(6) "London"
  ["paris"]=>
  string(5) "Paris"
  ["berlin"]=>
  string(6) "Berlin"
  ["bruxelles"]=>
  string(9) "Bruxelles"
  ["budapest"]=>
  string(8) "Budapest"
  ["prague"]=>
  string(6) "Prague"
}

Installation

composer require bentools/flatten-iterator

Unit tests

./vendor/bin/phpunit

See also

bentools/cartesian-product

bentools/string-combinations

bentools/iterable-functions