array_find_key
Devuelve la clave del primer elemento que valida la función de retrollamada
&reftitle.description;
mixedarray_find_key
arrayarray
callablecallback
array_find_key devuelve la clave del primer elemento de un
&array; para el cual la función de retrollamada callback
devuelve &true;. Si no se encuentra ningún elemento, la función devuelve &null;.
&reftitle.parameters;
array
El &array; a recorrer.
callback
La función de retrollamada a utilizar, que debe respetar la siguiente firma
boolcallback
mixedvalue
mixedkey
Si esta función devuelve &true;, la clave del elemento será devuelta por
array_find_key y la función de retrollamada no será
llamada para los otros elementos.
&reftitle.returnvalues;
La función devuelve la clave del primer elemento para el cual la función de
retrollamada callback devuelve &true;. Si no se
encuentra ningún elemento, la función devuelve &null;.
&reftitle.examples;
Ejemplo con array_find_key
'perro',
'b' => 'vaca',
'c' => 'gato',
'd' => 'pato',
'e' => 'oie',
'f' => 'elefante'
];
// Encontrar la clave del primer animal cuyo nombre tiene más de 5 caracteres.
var_dump(array_find_key($array, function (string $value) {
return strlen($value) > 5;
}));
// Encontrar la clave del primer animal cuyo nombre comienza con f.
var_dump(array_find_key($array, function (string $value) {
return str_starts_with($value, 'f');
}));
// Encontrar la clave del primer animal que es también la primera letra de su nombre.
var_dump(array_find_key($array, function (string $value, $key) {
return $value[0] === $key;
}));
// Encontrar la clave del primer animal que valida una RegEx.
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