(PHP 4, PHP 5, PHP 7, PHP 8)
prev — Сдвигает внутренний указатель массива на одну позицию назад
Функция продвигает внутренний указатель массива на одну позицию назад.
Функция prev() ведёт себя аналогично функции next(), за исключением того, что эта функция отматывает внутренний указатель массива на одну позицию, а не продвигает его.
array
Входной массив.
Возвращает значение предыдущего элемента массива,
относительно позиции внутреннего указателя,
или false
, если больше нет элементов.
Функция
возвращает как логическое значение false
,
так и нелогическое значение, которое приводится к false
.
Прочитайте раздел
«Логический тип»,
чтобы получить дополнительную информацию.
Используйте оператор ===
для проверки значения, которое возвращает функция.
Версия | Описание |
---|---|
8.1.0 | Вызов функции на значении с типом object устарел. Объект (object) либо сначала преобразовывают в массив (array) функцией get_mangled_object_vars(), либо пользуются методами класса наподобие ArrayIterator, в котором реализовали интерфейс Iterator. |
7.4.0 | Экземпляры классов библиотеки SPL теперь вместо вызова метода интерфейса Iterator, название которого аналогично названию этой функции, обрабатываются как пустые объекты без свойств. |
Пример #1 Пример продвижения внутреннего указателя массива функцией prev() с вызовом дружественных функций
<?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
. Чтобы отличить, нужно проверить, что возвращаемый функцией key() ключ предыдущего элемента, как его определяет функция prev(), не равен значениюnull
.