next

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

nextСдвигает внутренний указатель массива на одну позицию вперёд

Описание

next(array|object &$array): mixed

Функция next() ведёт себя аналогично функции current(), с одним отличием. Функция сдвигает внутренний указатель массива на одну позицию вперёд, прежде чем вернуть значение элемента, поэтому функция возвращает следующее значение массива и продвигает внутренний указатель массива на одну позицию.

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

array

Массив (array), на который повлияет функция.

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

Функция возвращает значение следующего элемента массива, относительно позиции внутреннего указателя, или false, если элементов не осталось.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Список изменений

Версия Описание
8.1.0 Вызов функции на значении с типом object устарел. Объект (object) либо сначала преобразовывают в массив (array) функцией get_mangled_object_vars(), либо пользуются методами класса наподобие ArrayIterator, в котором реализовали интерфейс Iterator.
7.4.0 Экземпляры классов библиотеки SPL теперь вместо вызова метода интерфейса Iterator, название которого аналогично названию этой функции, обрабатываются как пустые объекты без свойств.

Примеры

Пример #1 Пример сдвига внутреннего указателя массива функцией next() с вызовом дружественных функций

<?php

$transport
= array('foot', 'bike', 'car', 'plane');
echo
$mode = current($transport), PHP_EOL; // $mode = 'foot';
echo $mode = next($transport), PHP_EOL; // $mode = 'bike';
echo $mode = next($transport), PHP_EOL; // $mode = 'car';
echo $mode = prev($transport), PHP_EOL; // $mode = 'bike';
echo $mode = end($transport), PHP_EOL; // $mode = 'plane';

?>

Примечания

Замечание: Конец массива неотличим от элемента с логическим (bool) значением false. Правильно обойти массив с элементами false помогает управляющая конструкция foreach. Правильную проверку того, достиг ли указатель конца массива, функцией next() выполняют так: проверяют, что функция key() возвращает значение null.

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

  • current() - Возвращает текущий элемент массива
  • end() - Устанавливает внутренний указатель массива на последний элемент
  • prev() - Сдвигает внутренний указатель массива на одну позицию назад
  • reset() - Устанавливает внутренний указатель массива на первый элемент
  • each() - Возвращает текущую пару ключа и значения массива и сдвигает указатель на одну позицию вперёд