Setzt den internen Zeiger eines Arrays um ein Element zurück

(PHP 4, PHP 5, PHP 7)

prev — Setzt den internen Zeiger eines Arrays um ein Element zurück

Beschreibung

prev ( array &$array ) : mixed

Setzt den internen Arrayzeiger ein Element zurück.

prev() verhält sich genauso wie next(), abgesehen davon, dass es den Zeiger ein Element nach hinten bewegt, nicht nach vorne.

Parameter-Liste

array: Das Array, dessen Zeiger verschoben werden soll.

Rückgabewerte

Liefert den Wert des Elements vor der Position des Arrays, auf die der interne Zeiger 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.

Beispiele

Beispiel #1 Beispiel für die Verwendung von prev() und anderen


<?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 boolean FALSE-Wert zu unterscheiden. Dieser Fall kann unterschieden werden, indem geprüft wird, dass der key() des prev() Elements nicht NULL ist.

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 Zeiger eines Arrays vor
reset() - Setzt den internen Zeiger eines Arrays auf sein erstes Element
each() - Liefert das aktuelle Paar (Schlüssel und Wert) eines Arrays und rückt den Arrayzeiger vor