(PHP 4, PHP 5, PHP 7, PHP 8)
key — Получает ключ текущего элемента массива
Функция key() возвращает ключ элемента, который соответствует текущей позиции внутреннего указателя массива.
arrayМассив.
Функция key() только возвращает ключ
элемента, на который в текущий момент указывает
внутренний указатель массива, и не сдвигает указатель ни в каком
направлении. Функция key() вернёт null,
если внутренний указатель сдвинулся за пределы списка элементов
или при вызове на пустом массиве.
| Версия | Описание |
|---|---|
| 8.1.0 | Вызов функции на значении с типом object устарел. Объект (object) либо сначала преобразовывают в массив (array) функцией get_mangled_object_vars(), либо пользуются методами класса наподобие ArrayIterator, в котором реализовали интерфейс Iterator. |
| 7.4.0 | Экземпляры классов библиотеки SPL теперь вместо вызова метода интерфейса Iterator, название которого аналогично названию этой функции, обрабатываются как пустые объекты без свойств. |
Пример #1 Пример получения ключа текущего элемента массива функцией key()
<?php
$array = array(
'fruit1' => 'apple',
'fruit2' => 'orange',
'fruit3' => 'grape',
'fruit4' => 'apple',
'fruit5' => 'apple');
// Цикл выведет ключи ассоциативного массива,
// значения которых равны "apple"
while ($fruit_name = current($array)) {
if ($fruit_name == 'apple') {
echo key($array), "\n";
}
next($array);
}Результат выполнения приведённого примера:
fruit1 fruit4 fruit5