array_find_key

array_find_key(array $array, callable $callback): mixed
```php

`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`.

## Parámetros

`array`  
El `array` a recorrer.

`callback`  
La función de retrollamada a utilizar, que debe respetar la siguiente firma:

```php
callback(mixed $value, mixed $key): bool

<?php
$array = [
    'a' => '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);
}));
?>

string(1) "e"
NULL
string(1) "c"
string(1) "a"