array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.key.php', 1 => 'key', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Функции для работы с массивами', ), 'prev' => array ( 0 => 'function.key-exists.php', 1 => 'key_exists', ), 'next' => array ( 0 => 'function.krsort.php', 1 => 'krsort', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/array/functions/key.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
key — Получает ключ массива
Функция key() возвращает индекс текущей позиции массива.
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