array_key_first() │ WP 5.9.0

Получает первый ключ переданного массива. Не трогает внутренний указатель массива.

Функции все равно какой массив был передан (индексный или ассоциативный), она в любом случае вернет первый ключ (индекс) указанного массива.

Полифилл для функции array_key_first(), добавленной в PHP 7.3.

Используйте array_key_last(), когда нужно получить последний ключ массива.

1 раз — -0.00003 сек (скорость света) | 50000 раз — 0.00 сек (скорость света)

Хуков нет.

Возвращает

Строку|int|null. Первый ключ массива, если массив не пуст; null в противном случае.

Использование

array_key_first( $arr );
$arr(массив) (обязательный)
Массив первый ключ которого нужно получить.

Примеры

0

#1 Демонстрация 

$first_key = array_key_first( [ 1, 2 ] ); // 0

$first_key = array_key_first( [ 'one' => 1, 'two' => 2 ] ); // one
0

#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() WP 6.5.2

wp-includes/compat.php 
function array_key_first( array $array ) { // phpcs:ignore Universal.NamingConventions.NoReservedKeywordParameterNames.arrayFound
	foreach ( $array as $key => $value ) {
		return $key;
	}
}

Вспомогательные