array_find_key Retorna a chave do primeiro elemento que satisfaz uma função de retorno &reftitle.description; mixedarray_find_key arrayarray callablecallback array_find_key retorna a chave 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;, a chave é retornada por array_find_key e a função de retorno não será chamada para os elementos restantes. &reftitle.returnvalues; A função retorna a chave 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 mais longo que 4 caracteres. var_dump(array_find_key($array, function (string $value) { return strlen($value) > 4; })); // Encontra o primeiro animal cujo nome começa com f. var_dump(array_find_key($array, function (string $value) { return str_starts_with($value, 'f'); })); // Encontra o primeiro animal onde a chave do array é a primeira letra do animal. var_dump(array_find_key($array, function (string $value, $key) { return $value[0] === $key; })); // Encontra o primeiro animal onde o chave do array corresponde a uma expressão regular. var_dump(array_find_key($array, function ($value, $key) { return preg_match('/^([a-f])$/', $key); })); ?> ]]> &example.outputs; &reftitle.seealso; array_find array_all array_any array_filter array_reduce