array_find

    (PHP 8 >= 8.4.0)

    array_find — Retorna um primeiro elemento que satisfaz uma função de retorno

    Descrição

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

    array_find() retorna o valor do primeiro elemento de um array para o qual a função callback retorna true. Se nenhum elemento correspondente for encontrado, a função retorna null.

    Parâmetros

    array
    O array a ser pesquisado.
    callback

    A função de retorno a ser chamada para verificar cada elemento, que precisa ter a seguinte assinatura:

    callback(mixed $value, mixed $key): bool
    Se esta função retornar true, o valor é retornado por array_find() e a função de retorno não será chamada para os elementos restantes.

    Valor Retornado

    A função retorna o valor do primeiro elemento para o qual callback retorna true. Se nenhum elemento correspondente for encontrado, a função retorna null.

    Exemplos

    Exemplo #1 Exemplo de array_find()

    <?php
    $array     = [
    'a' => 'cachorro',
    'b' => 'gato',
    'c' => 'vaca',
    'd' => 'pato',
    'e' => 'elefante',
    'f' => 'ganso'
    ];

    // Encontra o primeiro animal com nome maior que 4 letras.
    var_dump(array_find($array, function (string $value) {
    return     strlen($value) > 4;
    }));

    // Encontra o primeiro animal cujo nome começa com f.
    var_dump(array_find($array, function (string $value) {
    return     str_starts_with($value, 'f');
    }));

    // Encontra o primeiro animal onde a chave do array é a primeira letra do nome.
    var_dump(array_find($array, function (string $value, $key) {
    return     $value[0] === $key;
    }));

    // Encontra o primeiro animal onde a chave do array corresponde a uma expressão regular.
    var_dump(array_find($array, function ($value, $key) {
    return     preg_match('/^([a-f])$/', $key);
    }));
    ?>

    O exemplo acima produzirá:

    string(8) "cachorro"
NULL
string(8) "elefante"
string(3) "cachorro"

    Veja Também

    • array_find_key() - Retorna a chave do primeiro elemento que satisfaz uma função de retorno
    • array_all() - Verifica se todos os elementos de um array satisfazem uma função de retorno
    • array_any() - Verifica se pelo menos um elemento de um array satisfaz uma função de retorno
    • array_filter() - Filtra elementos de um array utilizando uma função callback
    • array_reduce() - Reduz um array para um único valor através de um processo iterativo via callback

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicionar nota

    Notas de Usuários 1 note

    up
    11
    mail at nititech dot de
    6 months ago
    A simple fallback For older PHP versions, that do not have array_find:

    <?php

    /**
    * Porting of PHP 8.4 function
    *
    * @template TValue of mixed
    * @template TKey of array-key
    *
    * @param array<TKey, TValue> $array
    * @param callable(TValue $value, TKey $key): bool $callback
    * @return ?TValue
    *
    * @see https://www.php.net/manual/en/function.array-find.php
    */
    function array_find(array $array, callable $callback): mixed
    {
    foreach (    $array as $key => $value) {
    if (    $callback($value, $key)) {
    return     $value;
    }
    }

    return     null;
    }
    ?>
    ＋adicionar nota
    To Top