czproject/arrays

Array tools library.

CzProject\Arrays

, _(*1)

Array tools library., _(*2)

, _(*3)

Installation

Download a latest package or use Composer:, _(*4)

composer require czproject/arrays

CzProject\Arrays requires PHP 8.0 or later., _(*5)

Usage

``` php use CzProject\Arrays;, <sub>(*6)</sub>

### `flatten()`

``` php
$data = Arrays::flatten(array(
    'value 1',
    'values' => array(
        'value 2-1',
        'value 2-2',
        'value 2-3',
    ),
    'value 3',
));

/* Returns:
[
    'value 1',
    'value 2-1',
    'value 2-2',
    'value 2-3',
    'value 3',
]
*/

fetchPairs()

``` php $rows = array( array( 'id' => 1, 'name' => 'Row #1', ),, <sub>(*7)</sub>

array(
    'id' => 2,
    'name' => 'Row #2',
),

array(
    'id' => 3,
    'name' => 'Row #3',
),

);, <sub>(*8)</sub>

$data = Arrays::fetchPairs($rows, 'id', 'name');, <sub>(*9)</sub>

/* Returns: [ 1 => 'Row #1', 2 => 'Row #2', 3 => 'Row #3', ] */, <sub>(*10)</sub>

### `merge()`

``` php
$defaultConfig = array(
    'parameters' => array(
        'database' => array(
            'host' => 'localhost',
            'database' => 'lorem_ipsum',
            'driver' => 'mysql',
        ),
    ),

    'messages' => array(
        'success' => 'Success!',
        'error' => 'Error!',
    ),
);

$config = array(
    'parameters' => array(
        'database' => array(
            'user' => 'user123',
            'password' => 'password123',
        ),
    ),

    'messages' => array(
        'error' => 'Fatal Error!',
    ),
);

$data = Arrays::merge($config, $defaultConfig);

/* Returns:
[
    parameters => [
        database => [
            host => 'localhost',
            database => 'lorem_ipsum',
            driver => 'mysql',
            user => 'user123',
            password => 'password123',
        ]
    ],

    messages => [
        success => 'Success!',
        error => 'Fatal Error!',
    ]
]
*/

pushFrom()

``` php $a = ['A1', 'A2', 'A3', 'A4']; $b = ['B1', 'B2']; $result = [];, <sub>(*11)</sub>

for ($i = 0; $i < 4; $i++) { Arrays::pushFrom($result, $a); Arrays::pushFrom($result, $b); }, <sub>(*12)</sub>

/* Returns: [ 'A1', 'B1', 'A2', 'B2', 'A3', 'A4', ] */ ```, <sub>(*13)</sub>

License: New BSD License
Author: Jan Pecha, https://www.janpecha.cz/, <sub>(*14)</sub>