Setzt den internen Arrayzeiger um ein Element zurück

# prev

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

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

### Beschreibung

function 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

- 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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open