kamyshev/array_find

A PHP function that find element in an array by a callback.

, _(*1)

[DEPRECATED] This is no longer supported, please consider using array_actions instead., _(*2)

array_find

A PHP function that find element in an array by a callback., _(*3)

Installation

To get the latest version of array_find, simply require the project using Composer:, _(*4)

``` shell $ composer require kamyshev/array_find, <sub>(*5)</sub>

If you do not want to use Composer, you can just `require` the `src/array_find.php` file.

## Usage

To use `array_find`, simply pass an array and callback:

``` php
$records = [
    [
        'state'  => 'IN',
        'city'   => 'Indianapolis',
        'object' => 'School bus',
    ],
    [
        'state'  => 'IN',
        'city'   => 'Indianapolis',
        'object' => 'Manhole',
    ],
    [
        'state'  => 'IN',
        'city'   => 'Plainfield',
        'object' => 'Basketball',
    ],
    [
        'state'  => 'CA',
        'city'   => 'San Diego',
        'object' => 'Light bulb',
    ],
    [
        'state'  => 'CA',
        'city'   => 'Mountain View',
        'object' => 'Space pen',
    ],
];

$grouped = array_find($records, function ($state) {
    return $state['city'] === 'San Diego';
});

Example output:, <sub>(*6)</sub>

text Array ( [state] => CA [city] => San Diego [object] => Light bulb ), <sub>(*7)</sub>

If the element was not found, array_find returns null., <sub>(*8)</sub>