WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Iterator::current — den aktuellen Wert lesen

Lies den Wert an der aktuellen Position eines Iterators, ohne ihn weiterzuschalten. Prüfe die Position mit `valid()`, damit du `null` und `false` nicht mit dem Ende der Iteration verwechselst.

Version: PHP 8.3

Syntax

public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instance

Iterator::current ist eine öffentliche Instanzmethode ohne Parameter. Sie gibt den Wert an der aktuellen Position des Iterators zurück. Der Rückgabetyp mixed erlaubt jeden PHP-Wert, auch null und false. $iterator->current() schaltet den Iterator nicht weiter: Das übernimmt next(), während key() statt des Werts den Schlüssel liest.

Wenn du den Iterator manuell von Anfang an durchläufst, rufe zuerst rewind() auf. Prüfe danach und nach jedem next() mit valid(), ob die Position gültig ist, bevor du einen Wert liest. Gibt valid() den Wert false zurück, rufe current() nicht auf: Die Schnittstelle legt kein Ergebnis für eine ungültige Position fest. Prüfe das Ende weder durch Umwandlung des Werts in bool noch durch Vergleich mit null oder false.

In einer gewöhnlichen foreach-Schleife über einen Iterator ruft PHP zu Beginn rewind() auf und prüft valid(), bevor es den Wert über current() liest. Die Form foreach ($iterator as $key => $value) liest über key() auch den Schlüssel. Wird die Schleife mit dem nächsten Durchlauf fortgesetzt, ruft PHP next() auf und prüft die Position erneut.

Verwechsle die Methode nicht mit der globalen Funktion \current($array), die das Element am internen Zeiger eines Arrays liest. Seit PHP 8.1 ist es veraltet, dieser Funktion ein Objekt zu übergeben. Das ersetzt keinen Aufruf der Iteratormethode.

Beispiele

<?php
$iterator = new \ArrayIterator(['a' => null, 'b' => false]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    $value = $iterator->current();
    printf("%s: %s\n", $iterator->key(), var_export($value, true));
}

Ergebnis

a: NULL
b: false

Das Beispiel erfordert keine optionale Erweiterung: `Iterator` ist in PHP 8.3 eingebaut, und SPL lässt sich in dieser Version nicht deaktivieren. Die SPL-Klasse `\ArrayIterator` durchläuft die beiden Array-Einträge in Einfügereihenfolge. `var_export($value, true)` liefert den Text `NULL` oder `false`, sodass beide Werte sichtbar sind. Die Schleife endet, wenn `valid()` den Wert `false` zurückgibt, nicht wenn der gelesene Wert `false` ist.

Zugehörige Lektionen

  • PHP · Lektion 61 · Fortgeschritten · Version: 2
  • PHP · Lektion 63 · Fortgeschritten · Version: 2

Quellen