current - Возвращает текущий элемент массива
Вернуться к: Функции для работы с массивами
current
(PHP 4, PHP 5, PHP 7)
current — Возвращает текущий элемент массива
Описание
У каждого массива имеется внутренний указатель на его "текущий" элемент, который инициализирован первым элементом, добавленным в массив.
Список параметров
-
array
-
Массив.
Возвращаемые значения
Функция current() просто возвращает значение
элемента массива, на который указывает его внутренний указатель.
Она не перемещает указатель куда бы то ни было. Если
внутренний указатель находится за пределами списка элементов или
массив пуст, current() возвращает FALSE
.
Эта функция
может возвращать как boolean FALSE
, так и не-boolean значение,
которое приводится к FALSE
. За более подробной информацией обратитесь к разделу
Булев тип. Используйте оператор === для проверки значения,
возвращаемого этой функцией.
Примеры
Пример #1 Пример использования current() и дружественных функций
<?php
$transport = array('foot', 'bike', 'car', 'plane');
$mode = current($transport); // $mode = 'foot';
$mode = next($transport); // $mode = 'bike';
$mode = current($transport); // $mode = 'bike';
$mode = prev($transport); // $mode = 'foot';
$mode = end($transport); // $mode = 'plane';
$mode = current($transport); // $mode = 'plane';
$arr = array();
var_dump(current($arr)); // bool(false)
$arr = array(array());
var_dump(current($arr)); // array(0) { }
?>
Примечания
Замечание: Вы не сможете отличить конец массива от boolean элемента
FALSE
. Для корректного обхода массива, который может содержатьFALSE
элементы, смотрите функцию each().
Смотрите также
- end() - Устанавливает внутренний указатель массива на его последний элемент
- key() - Выбирает ключ из массива
- each() - Возвращает текущую пару ключ/значение из массива и смещает его указатель
- prev() - Передвигает внутренний указатель массива на одну позицию назад
- reset() - Устанавливает внутренний указатель массива на его первый элемент
- next() - Передвигает внутренний указатель массива на одну позицию вперёд
Вернуться к: Функции для работы с массивами