(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(), либо пользуются методами класса, в котором реализовали интерфейс Iterator, например, ArrayIterator. |
7.4.0 | Экземпляры классов библиотеки SPL теперь обрабатываются как пустые объекты, у которых нет свойств, вместо вызова метода интерфейса Iterator с тем же именем, что и у этой функция. |
Пример #1 Пример использования функции prev() и дружественных функций
<?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
. Чтобы отличить, нужно проверить, что возвращаемый функцией key() ключ предыдущего элемента, как его определяет функция prev(), не равен значениюnull
.