Функции для работы с массивами
PHP Manual

current

(PHP 4, PHP 5, PHP 7)

currentВозвращает текущий элемент массива

Описание

mixed current ( array $array )

У каждого массива имеется внутренний указатель на его "текущий" элемент, который инициализируется первым элементом, добавленным в массив.

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

array

Массив.

Возвращаемые значения

Функция current() просто возвращает значение элемента массива, на который указывает его внутренний указатель. Она не перемещает указатель куда бы то ни было. Если внутренний указатель находится за пределами списка элементов или массив пуст, current() возвращает FALSE.

Внимание

Эта функция может возвращать как boolean 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.

Смотрите также


Функции для работы с массивами
PHP Manual