end

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

    end — Positioniert den internen Zeiger eines Arrays auf dessen letztes Element

    Beschreibung

    end(array|object&$array): mixed

    end() rückt den internen Zeiger von array bis zum letzten Element vor und gibt dessen Wert zurück.

    Parameter-Liste

    array

    Das Array. Das Array wird per Referenz übergeben, weil es von der Funktion bearbeitet wird. Das bedeutet, dass der Funktion eine echte Variable übergeben werden muss und nicht beispielsweise der Rückgabewert einer Funktion.

    Rückgabewerte

    Gibt den Wert des letzten Arrayelements zurück oder false bei einem leeren Array.

    Changelog

    VersionBeschreibung
    8.1.0 Bei Objekten ist die Verwendung dieser Funktion veraltet. Stattdessen sollte entweder das Objekt vorher mit get_mangled_object_vars() in ein Array umgewandelt werden oder es sollten die Methoden einer Klasse verwendet werden, die Iterator implementiert, z. B. ArrayIterator.
    7.4.0 Instanzen von SPL-Klassen werden nun wie leere Objekte behandelt, die keine Eigenschaften haben, anstatt die Iterator-Methode aufzurufen, die den gleichen Namen wie diese Funktion hat.

    Beispiele

    Beispiel #1 end()-Beispiel

    <?php

    $fruits     = array('apple', 'banana', 'cranberry');
    echo     end($fruits); // cranberry

    ?>

    Siehe auch

    • current() - Liefert das aktuelle Element eines Arrays
    • each() - Liefert das aktuelle Schlüssel-Wert-Paar eines Arrays und rückt den Arrayzeiger vor
    • prev() - Setzt den internen Arrayzeiger um ein Element zurück
    • reset() - Setzt den internen Zeiger eines Arrays auf sein erstes Element
    • next() - Rückt den internen Arrayzeiger vor
    • array_key_last() - Ermittelt den letzten Schlüssel eines Arrays
    To Top