CKTIS / PHP
Iterator::next — passare all’elemento successivo
`Iterator::next()` fa avanzare un iteratore di un passo senza restituire l’elemento. Se scorri l’iteratore manualmente, controlla `valid()` prima di leggere il valore con `current()`.
Versione: PHP 8.3
Sintassi
public function Iterator::next(): void
Instance call: $iterator->next();Iterator::next è un metodo pubblico di istanza dell’interfaccia Iterator. La chiamata $iterator->next() non accetta argomenti e modifica la posizione dello stesso oggetto. In PHP 8.3 il tipo di ritorno void di questo metodo dell’interfaccia è provvisorio. Il metodo è distinto dalla funzione globale \next($array), che fa avanzare il puntatore interno di un array e restituisce il valore nella nuova posizione, oppure false se non c’è un elemento successivo.
In PHP 8.3 l’interfaccia Iterator è integrata e la classe ArrayIterator usata nell’esempio fa parte della SPL, sempre disponibile. Non occorre abilitare alcuna estensione facoltativa.
Per scorrere l’iteratore manualmente, inizia con rewind(). Controlla la posizione con valid() prima di leggere il valore con current() o la chiave con key(). Chiama next() dopo aver elaborato l’elemento. Una volta superato l’ultimo elemento, valid() restituisce false: usa questo risultato per rilevare la fine, non il valore dell’elemento o il risultato di next().
Con un oggetto Iterator, foreach chiama rewind() all’inizio, poi chiama next() e controlla valid() nel passaggio da un’iterazione alla successiva. Non chiamare di nuovo next() nel corpo del ciclo, a meno che tu non voglia saltare degli elementi. Un break esce dal ciclo senza un ulteriore avanzamento automatico.
Esempi
<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();
while ($iterator->valid()) {
echo $iterator->current(), "\n";
$iterator->next();
}
var_dump($iterator->valid());
Risultato
red blue bool(false)
L’esempio usa `ArrayIterator` della SPL. Stampa prima `red` e, dopo il primo avanzamento, `blue`. Dopo il secondo, `valid()` restituisce `false`, visualizzato come `bool(false)`.
Lezioni correlate
- PHP · Lezione 61 · Avanzato · Versione: 2
- PHP · Lezione 63 · Avanzato · Versione: 2