array_find_key
Возвращает ключ первого элемента, подходящего под условие.
Синтаксис
array_find_key(array $array, callable $callback): int|string|nullПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $array | array | Исходный массив. |
| $callback | callable | Функция-проверка: получает значение и ключ. |
Возвращаемое значение
int|string|nullКлюч или `null`, если ничего не найдено.
Примеры
Кто первым набрал больше 90:
<?php
$scores = ['Anna' => 72, 'Oleg' => 95, 'Ivan' => 98];
echo array_find_key($scores, fn ($score) => $score > 90);Результат:
OlegПримечания
Функция появилась в PHP 8.4. array_search() ищет точное значение, а эта функция — по условию.
См. также
- array_find — Возвращает первый элемент, для которого функция вернула true.
- array_search — Ищет значение в массиве и возвращает его ключ.
- array_key_first — Возвращает первый ключ массива.
В учебнике
- Новое в PHP 8.4 — Возможности PHP 8.4 — хуки свойств, раздельная видимость чтения и записи, вызов метода сразу после new и новые функции для массивов.