PHP 8.4.1 Released!

    array_find

    (PHP 8 >= 8.4.0)

    array_find — Returns the first element satisfying a callback function

    Descripción

    array_find(array $array, callable $callback): mixed

    array_find() returns the value of the first element of an array for which the given callback returns true. If no matching element is found the function returns null.

    Parámetros

    array
    The array that should be searched.
    callback

    The callback function to call to check each element, which must be

    callback(mixed $value, mixed $key): bool
    If this function returns true, the value is returned from array_find() and the callback will not be called for further elements.

    Valores devueltos

    The function returns the value of the first element for which the callback returns true. If no matching element is found the function returns null.

    Ejemplos

    Ejemplo #1 array_find() example

    <?php
    $array     = [
    'a' => 'dog',
    'b' => 'cat',
    'c' => 'cow',
    'd' => 'duck',
    'e' => 'goose',
    'f' => 'elephant'
    ];

    // Find the first animal with a name longer than 4 characters.
    var_dump(array_find($array, function (string $value) {
    return     strlen($value) > 4;
    }));

    // Find the first animal whose name begins with f.
    var_dump(array_find($array, function (string $value) {
    return     str_starts_with($value, 'f');
    }));

    // Find the first animal where the array key is the first symbol of the animal.
    var_dump(array_find($array, function (string $value, $key) {
    return     $value[0] === $key;
    }));

    // Find the first animal where the array key matching a RegEx.
    var_dump(array_find($array, function ($value, $key) {
    return     preg_match('/^([a-f])$/', $key);
    }));
    ?>

    El resultado del ejemplo sería:

    string(5) "goose"
NULL
string(3) "cow"
string(3) "dog"

    Ver también

    • array_find_key() - Returns the key of the first element satisfying a callback function
    • array_all() - Checks if all array elements satisfy a callback function
    • array_any() - Checks if at least one array element satisfies a callback function
    • array_filter() - Filtra elementos de un array usando una función de devolución de llamada
    • array_reduce() - Reduce iterativamente un array a un solo valor usando una función llamada de retorno

    Improve This Page

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes

    There are no user contributed notes for this page.
    To Top