(PHP 4, PHP 5, PHP 7)
current — Возвращает текущий элемент массива
У каждого массива имеется внутренний указатель на его "текущий" элемент, который инициализируется первым элементом, добавленным в массив.
arrayМассив.
Функция current() просто возвращает значение
элемента массива, на который указывает его внутренний указатель.
Она не перемещает указатель куда бы то ни было. Если
внутренний указатель находится за пределами списка элементов или
массив пуст, current() возвращает FALSE.
Эта функция может возвращать как логическое значение FALSE, так и значение не типа boolean, которое приводится к FALSE. За более подробной информацией обратитесь к разделу Булев тип. Используйте оператор === для проверки значения, возвращаемого этой функцией.
| Версия | Описание |
|---|---|
| 7.0.0 |
Теперь параметр array всегда передается по значению.
Раньше он по возможности передавался по ссылке.
|
Пример #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) { }
?>
Замечание: Конец массива и результат вызова current() на пустом массиве неотличимы от элемента массива типа boolean со значением
FALSE. Для корректного обхода массива, который может содержатьFALSE, используйте функцию foreach(). Если же вы хотите использовать функцию current() и при этом корректно отслеживать конец массива, используйте функцию key() на том же элементе, на котором использовали current() и проверяйте ее результат на строгое неравенствоNULL.