array_find Retorna um primeiro elemento que satisfaz uma função de retorno &reftitle.description; mixedarray_find arrayarray callablecallback 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;. &reftitle.parameters; 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: boolcallback mixedvalue mixedkey 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. &reftitle.returnvalues; 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;. &reftitle.examples; '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); })); ?> ]]> &example.outputs; &reftitle.seealso; array_find_key array_all array_any array_filter array_reduce