array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.prev.php', 1 => 'prev', 2 => 'Setzt den internen Arrayzeiger um ein Element zurück', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Array Funktionen', ), 'prev' => array ( 0 => 'function.pos.php', 1 => 'pos', ), 'next' => array ( 0 => 'function.range.php', 1 => 'range', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', 'path' => 'reference/array/functions/prev.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

prev

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

prev — Setzt den internen Arrayzeiger um ein Element zurück

Beschreibung

prev(array|object &$array): mixed

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.

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 prev() und Freunden

<?php
$transport = array('zu Fuß', 'Fahrrad', 'Auto', 'Flugzeug');
echo $mode = current($transport), PHP_EOL; // $mode = 'zu Fuß';
echo $mode = next($transport), PHP_EOL; // $mode = 'Fahrrad';
echo $mode = next($transport), PHP_EOL; // $mode = 'Auto';
echo $mode = prev($transport), PHP_EOL; // $mode = 'Fahrrad';
echo $mode = end($transport), PHP_EOL; // $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 nicht null ist.

Siehe auch