CKTIS / PHP
Iterator::next — przejście do następnego elementu
`Iterator::next()` przesuwa pozycję iteratora o jeden krok i nie zwraca elementu. Przy ręcznej iteracji sprawdź `valid()`, zanim odczytasz wartość metodą `current()`.
Wersja: PHP 8.3
Składnia
public function Iterator::next(): void
Instance call: $iterator->next();Iterator::next to publiczna metoda instancji interfejsu Iterator. Wywołanie $iterator->next() nie przyjmuje argumentów i zmienia pozycję tego samego obiektu. W PHP 8.3 typ zwracany void tej metody interfejsu jest deklaracją wstępną (ang. tentative return type). To nie to samo co globalna funkcja \next($array), która przesuwa wewnętrzny wskaźnik tablicy i zwraca wartość spod nowej pozycji albo false, gdy nie ma następnego elementu.
W PHP 8.3 interfejs Iterator jest wbudowany, a użyta w przykładzie klasa ArrayIterator należy do obowiązkowego rozszerzenia SPL. Nie trzeba włączać żadnego opcjonalnego rozszerzenia.
Przy ręcznej iteracji zacznij od rewind(). Przed odczytem wartości przez current() lub klucza przez key() sprawdź pozycję metodą valid(). Wywołuj next() po przetworzeniu elementu. Po przejściu za ostatni element valid() zwraca false; koniec rozpoznawaj po tym wyniku, a nie po wartości elementu ani wyniku next().
Dla obiektu Iterator pętla foreach sama wywołuje na początku rewind(), a między iteracjami przesuwa pozycję przez next() i sprawdza valid(). Nie wywołuj dodatkowo next() w ciele pętli, jeśli nie chcesz pomijać elementów. break kończy pętlę bez kolejnego automatycznego przesunięcia.
Przykłady
<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();
while ($iterator->valid()) {
echo $iterator->current(), "\n";
$iterator->next();
}
var_dump($iterator->valid());
Wynik
red blue bool(false)
Przykład używa `ArrayIterator` z SPL. Najpierw wypisuje `red`, po pierwszym przesunięciu wypisuje `blue`, a po drugim `valid()` zwraca `false`, co widać jako `bool(false)`.
Powiązane lekcje
- PHP · Lekcja 61 · Zaawansowany · Wersja: 2
- PHP · Lekcja 63 · Zaawansowany · Wersja: 2