key

(PHP 4, PHP 5, PHP 7, PHP 8)

key — Вибір ключа з масиву

Опис

key(array|object $array): int|string|null

key() повертає індекс поточного масиву елемента.

Список параметрів

array

Масив.

Значення, що повертаються

Функцияkey() просто повертає ключ того елемента масиву, який в даний момент вказує внутрішній покажчик масиву. Вона не зрушує покажчик у жодному напрямку. Якщо внутрішній покажчик вказує поза межами масиву або масив порожній, key()возвратитnull

список змін

Версия	Опис
8.1.0	Виклик функції в об'єкті (object) оголошено застарілим. Або спочатку перетворіть об'єкт (object) на масив (array) за допомогою функції get_mangled_object_vars(), або використовуйте методи, що надаються класом, що реалізує інтерфейс Iterator, наПриклад,ArrayIterator
7.4.0	Примірники класів SPL тепер обробляються як порожні об'єкти, які мають властивостей, замість виклику методу Iterator з тим самим ім'ям, що і ця функція.

Приклади

Приклад #1 Приклад використання key()****

Loading...
▶

Результат виконання наведеного прикладу:

fruit1
fruit4
fruit5

Дивіться також

• current() - Повертає поточний елемент масиву
• next() - Переміщує покажчик масиву вперед на один елемент
• array_key_first() - Отримує перший ключ масиву
• foreach