array_key_first()
Получает первый ключ переданного массива. Не трогает внутренний указатель массива.
Функции все равно какой массив был передан (индексный или ассоциативный), она в любом случае вернет первый ключ (индекс) указанного массива.
Полифилл для функции array_key_first(), добавленной в PHP 7.3.
Используйте array_key_last(), когда нужно получить последний ключ массива.
1 раз — -0.00003 сек (скорость света) | 50000 раз — 0.00 сек (скорость света)
Хуков нет.
Возвращает
Строку|int|null. Первый ключ массива, если массив не пуст; null в противном случае.
Использование
array_key_first( $arr );
- $arr(массив) (обязательный)
- Массив первый ключ которого нужно получить.
Примеры
#1 Демонстрация
$first_key = array_key_first( [ 1, 2 ] ); // 0 $first_key = array_key_first( [ 'one' => 1, 'two' => 2 ] ); // one
#2 Пример того как сохраняется внутренний указатель массива.
$arr = [ 'one' => 1, 'two' => 2 ]; next( $arr ); // переключем внутренний указатель массива echo key( $arr ); // two echo array_key_first( $arr ); // one echo key( $arr ); // two
Список изменений
| С версии 5.9.0 | Введена. |
Код array_key_first() array key first WP 6.7.1
function array_key_first( array $array ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
foreach ( $array as $key => $value ) {
return $key;
}
}