end

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

endУстанавливает внутренний указатель массива на последний элемент

Описание

end(array|object &$array): mixed

Функция end() сдвигает внутренний указатель массива array на последний элемент и возвращает значение последнего элемента.

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

array

Массив. Функция изменяет массив, поэтому аргумент передаётся по ссылке. Массив потребуется передать как переменную, а не как функцию, которая возвращает массив, поскольку по ссылке передаются только переменные.

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

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

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

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

Примеры

Пример #1 Пример получения значения последнего элемента массива массива функцией end()

<?php

$fruits
= array('яблоко', 'банан', 'клюква');
echo
end($fruits); // клюква

?>

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

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