(PHP 8 >= 8.4.0)
array_find — Retorna um primeiro elemento que satisfaz uma função de retorno
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.
A função retorna o valor do primeiro elemento para o qual
callback returna true. Se nenhum elemento correspondente for
encontrado, a função retorna null.
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"