array_find_key
Возвращает ключ первого элемента, который удовлетворяет callback-функции
&reftitle.description;
mixedarray_find_key
arrayarray
callablecallback
Функция array_find_key возвращает ключ первого элемента
массива (&array;), для которого callback-функция вернула &true;.
Функция вернёт &null;, если не найдёт ни одного элемента, который удовлетворяет условиям поиска.
&reftitle.parameters;
array
Массив (&array;), в котором требуется найти ключ.
callback
Callback-функция, которую функция вызовет для проверки элементов входного массива, со следующей сигнатурой:
boolcallback
mixedvalue
mixedkey
Функция array_find_key вернёт ключ и не станет
вызывать callback-функцию для других элементов,
если функция обратного вызова вернёт &true;.
&reftitle.returnvalues;
Функция возвращает ключ первого элемента, для которого
callback-функция вернула &true;. Функция вернёт &null;,
если не найдёт элемент, который удовлетворяет условиям поиска.
&reftitle.examples;
Пример поиска функцией array_find_key первого ключа, который удовлетворяет callback-функции
'dog',
'b' => 'cat',
'c' => 'cow',
'd' => 'duck',
'e' => 'goose',
'f' => 'elephant'
];
// Найдём ключ первого животного, название которого длиннее 4 символов
var_dump(array_find_key($array, function (string $value) {
return strlen($value) > 4;
}));
// Найдём ключ первого животного, название которого начинается с буквы f
var_dump(array_find_key($array, function (string $value) {
return str_starts_with($value, 'f');
}));
// Найдём ключ первого животного, который совпадает с первой буквой названия
var_dump(array_find_key($array, function (string $value, $key) {
return $value[0] === $key;
}));
// Найдём ключ первого животного, который соответствует регулярному выражению
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