next

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

    next — Rückt den internen Arrayzeiger vor

    Beschreibung

    next(array|object&$array): mixed

    next() verhält sich ähnlich wie current(), mit einem Unterschied: Der interne Zeiger wird um ein Element vorgerückt, bevor der Wert des Elements zurückgegeben wird, d. h. es wird der Wert des nächsten Elements zurückgegeben und der interne Zeiger um eins erhöht.

    Parameter-Liste

    array

    Das betreffende Array.

    Rückgabewerte

    Gibt den Wert des nächsten Elements des Arrays zurück, auf das der interne Zeiger des Arrays gerade zeigt. Sind keine Elemente mehr vorhanden, wird false zurückgegeben.

    Warnung

    Diese Funktion kann sowohl das boolsche false zurückliefern, als auch einen nicht-boolschen Wert, welcher zu false ausgewertet wird. Weitere Informationen entnehmen Sie bitte dem Abschnitt über die boolschen Typen. Benutzen Sie deshalb den === Operator, um den Rückgabewert dieser Funktion zu überprüfen.

    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 Beispiel für die Verwendung von next() und Freunden

    <?php
    $transport     = array('zu Fuß', 'Fahrrad', 'Auto', 'Flugzeug');
    $mode = current($transport); // $mode = 'zu Fuß';
    $mode = next($transport); // $mode = 'Fahrrad';
    $mode = next($transport); // $mode = 'Auto';
    $mode = prev($transport); // $mode = 'Fahrrad';
    $mode = end($transport); // $mode = 'Flugzeug';
    ?>

    Anmerkungen

    Hinweis: Das Ende eines Arrays ist von einem boolschen false-Element nicht zu unterscheiden. Um ein Array, das möglicherweise false-Elemente enthält, ordnungsgemäß zu durchlaufen, kann foreach verwendet werden. Um next() dennoch zu verwenden und ordnungsgemäß zu prüfen, ob das Ende des Arrays erreicht wurde, sollte geprüft werden, ob key()null ist.

    Siehe auch

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