(PHP 4, PHP 5, PHP 7, PHP 8)
key — Выбирает ключ из массива
$array
): int|string|nullkey() возвращает индекс текущего элемента массива.
array
Массив.
Функция key() просто возвращает ключ
того элемента массива, на который в данный момент указывает
внутренний указатель массива. Она не сдвигает указатель ни в каком
направлении. Если внутренний указатель указывает вне границ массива
или массив пуст, key() возвратит null
.
Версия | Описание |
---|---|
8.1.0 | Вызов функции в объекте (object) объявлен устаревшим. Либо сначала преобразуйте объект (object) в массив (array) с помощью функции get_mangled_object_vars(), либо используйте методы, предоставляемые классом, реализующим интерфейс Iterator, например, ArrayIterator. |
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