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() - Получает последний ключ массива