key
(PHP 4, PHP 5, PHP 7)
key — Выбирает ключ из массива
Описание
key
( array|object
$array
) : int|string|nullkey() возвращает индекс текущего элемента массива.
Список параметров
-
array -
Массив.
Возвращаемые значения
Функция key() просто возвращает ключ
того элемента массива, на который в данный момент указывает
внутренний указатель массива. Она не сдвигает указатель ни в каком
направлении. Если внутренний указатель указывает вне границ массива
или массив пуст, key() возвратит null.
Список изменений
| Версия | Описание |
|---|---|
| 7.0.0 |
Теперь параметр array всегда передается по значению.
Раньше он по возможности передавался по ссылке.
|
Примеры
Пример #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).'<br />';
}
next($array);
}
?>
Результат выполнения данного примера:
fruit1<br /> fruit4<br /> fruit5<br />