prev
(PHP 4, PHP 5, PHP 7, PHP 8)
prev — Setzt den internen Arrayzeiger um ein Element zurück
Beschreibung
Setzt den internen Zeiger eines Arrays um ein Element zurück.
prev() verhält sich genauso wie next(), abgesehen davon, dass es den Zeiger um ein Element zurücksetzt, nicht nach vorne.
Parameter-Liste
-
array -
Das Eingabe-Array.
Rückgabewerte
Gibt den Wert des Array-Elements vor der Position zurück, auf die der
interne Zeiger 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 prev() 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: Es ist nicht möglich, den Anfang eines Arrays von einem boolschen
false-Element zu unterscheiden. Dieser Fall kann unterschieden werden, indem geprüft wird, ob der key() des prev() Elements nichtnullist.
Siehe auch
- current() - Liefert das aktuelle Element eines Arrays
- end() - Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
- next() - Rückt den internen Arrayzeiger vor
- 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
