Rückt den internen Arrayzeiger vor

(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

Version	Beschreibung
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