next
(PHP 4, PHP 5, PHP 7, PHP 8)
next — Rückt den internen Arrayzeiger vor
Beschreibung
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.
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 | Die Verwendung dieser Funktion bei Objekten ist veraltet. Entweder sollte zuerst get_mangled_object_vars() auf das Objekt angewendet werden oder sollte ArrayIterator verwendet werden. |
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öglicherweisefalse-Elemente enthält, ordnungsgemäß zu durchlaufen, kannforeachverwendet werden. Um next() dennoch zu verwenden und ordnungsgemäß zu prüfen, ob das Ende des Arrays erreicht wurde, sollte geprüft werden, ob key()nullist.
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
