WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

Iterator::next — zum nächsten Element wechseln

`Iterator::next()` bewegt einen Iterator um einen Schritt weiter, ohne das Element zurückzugeben. Prüfe beim manuellen Durchlaufen zuerst `valid()`, bevor du den Wert mit `current()` liest.

Version: PHP 8.3

Syntax

public function Iterator::next(): void

Instance call: $iterator->next();

Iterator::next ist eine öffentliche Instanzmethode der Schnittstelle Iterator. Der Aufruf $iterator->next() erwartet keine Argumente und ändert die Position desselben Objekts. In PHP 8.3 ist void als Rückgabetyp dieser Schnittstellenmethode vorläufig deklariert. Davon zu unterscheiden ist die globale Funktion \next($array): Sie bewegt den internen Zeiger eines Arrays weiter und gibt den Wert an der neuen Position zurück oder false, wenn es kein nächstes Element gibt.

In PHP 8.3 ist Iterator fest eingebaut. Die im Beispiel verwendete Klasse ArrayIterator gehört zur SPL, die immer verfügbar ist. Es muss keine optionale Erweiterung aktiviert werden.

Beginne beim manuellen Durchlaufen mit rewind(). Prüfe die Position mit valid(), bevor du den Wert mit current() oder den Schlüssel mit key() liest. Rufe next() nach der Verarbeitung des Elements auf. Hinter dem letzten Element liefert valid() den Wert false. Verwende dieses Ergebnis, um das Ende zu erkennen, nicht den Elementwert oder das Ergebnis von next().

Bei einem Iterator-Objekt ruft foreach zu Beginn rewind() auf. Beim Übergang zum nächsten Durchlauf ruft die Schleife next() auf und prüft valid(). Rufe next() im Schleifenrumpf nicht zusätzlich auf, sofern du keine Elemente überspringen willst. break beendet die Schleife ohne einen weiteren automatischen Schritt.

Beispiele

<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();

while ($iterator->valid()) {
    echo $iterator->current(), "\n";
    $iterator->next();
}

var_dump($iterator->valid());

Ergebnis

red
blue
bool(false)

Das Beispiel verwendet `ArrayIterator` aus der SPL. Es gibt zuerst `red` und nach dem ersten Schritt `blue` aus. Nach dem zweiten Schritt liefert `valid()` den Wert `false`, angezeigt als `bool(false)`.

Zugehörige Lektionen

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

Quellen