Liefert das aktuelle Element eines Arrays

# current

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

current — Liefert das aktuelle Element eines Arrays

### Beschreibung

function current(array|object `$array`): mixed

Jedes Array hat einen internen Zeiger auf sein "aktuelles" Element, welcher auf das erste in das Array eingefügte Element initialisiert wird.

### Parameter-Liste

`array`

  Das Array.

### Rückgabewerte

Die Funktion current() gibt den Wert des Array-Elements zurück, auf das der interne Zeiger gerade zeigt. Sie bewegt den Zeiger überhaupt nicht. Zeigt der interne Zeiger hinter das Ende der Elementliste, gibt current() `false` zurück.

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 current() 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 = current($transport), PHP_EOL; // $mode = 'Fahrrad';
    echo $mode = prev($transport), PHP_EOL;    // $mode = 'zu Fuß';
    echo $mode = end($transport), PHP_EOL;     // $mode = 'Flugzeug';
    echo $mode = current($transport), PHP_EOL; // $mode = 'Flugzeug';

    $arr = array();
    var_dump(current($arr)); // bool(false)

    $arr = array(array());
    var_dump(current($arr)); // array(0) { }
    ?>

### Anmerkungen

> Hinweis: Das Ergebnis des Aufrufs von current() auf ein leeres Array und auf ein Array, dessen interner Zeiger hinter das Ende der Elemente zeigt, sind nicht unterscheidbar von einem boolschen `false`-Element. Um ein Array, das möglicherweise `false`-Elemente enthält, korrekt zu durchlaufen, siehe die Kontrollstruktur `foreach`. Um current() dennoch zu verwenden und korrekt zu prüfen, ob der Wert tatsächlich ein Element des Arrays ist, sollte überprüft werden, ob sich der key() des current()-Elements im strikten Vergleich von `null` unterscheidet.

### Siehe auch

- end() - Positioniert den internen Zeiger eines Arrays auf dessen letztes Element
- key() - Liefert einen Schlüssel eines Arrays
- each() - Liefert das aktuelle Schlüssel-Wert-Paar eines Arrays und rückt den Arrayzeiger vor
- prev() - Setzt den internen Arrayzeiger um ein Element zurück
- reset() - Setzt den internen Zeiger eines Arrays auf sein erstes Element
- next() - Rückt den internen Arrayzeiger vor
- `foreach`

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