CKTIS / PHP
Iterator::next — avanzar al elemento siguiente
`Iterator::next()` avanza un iterador un paso sin devolver el elemento. Si recorres el iterador manualmente, comprueba `valid()` antes de leer el valor con `current()`.
Versión: PHP 8.3
Sintaxis
public function Iterator::next(): void
Instance call: $iterator->next();Iterator::next es un método público de instancia de la interfaz Iterator. La llamada $iterator->next() no recibe argumentos y cambia la posición del mismo objeto. En PHP 8.3, el tipo de retorno void de este método de la interfaz es provisional. El método es distinto de la función global \next($array), que avanza el puntero interno de un array y devuelve el valor de la nueva posición, o false si no hay un elemento siguiente.
En PHP 8.3, la interfaz Iterator está integrada y la clase ArrayIterator del ejemplo forma parte de SPL, que siempre está disponible. No hace falta activar ninguna extensión opcional.
Para recorrer el iterador manualmente, empieza con rewind(). Comprueba la posición con valid() antes de leer el valor con current() o la clave con key(). Llama a next() después de procesar el elemento. Al pasar del último elemento, valid() devuelve false. Usa ese resultado para detectar el final, no el valor del elemento ni el resultado de next().
Con un objeto Iterator, foreach llama a rewind() al inicio. Para pasar de una iteración a la siguiente, llama a next() y comprueba valid(). No vuelvas a llamar a next() dentro del bucle a menos que quieras saltarte elementos. Un break sale del bucle sin otro avance automático.
Ejemplos
<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();
while ($iterator->valid()) {
echo $iterator->current(), "\n";
$iterator->next();
}
var_dump($iterator->valid());
Resultado
red blue bool(false)
El ejemplo usa `ArrayIterator` de SPL. Primero muestra `red` y, tras el primer avance, muestra `blue`. Tras el segundo avance, `valid()` devuelve `false`, que se muestra como `bool(false)`.
Lecciones relacionadas
- PHP · Lección 61 · Avanzado · Versión: 2
- PHP · Lección 63 · Avanzado · Versión: 2