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