CKTIS / PHP
Iterator::valid — Comprobar la posición actual del iterador
`Iterator::valid()` indica si hay un elemento en la posición actual del iterador. El método no evalúa el valor de ese elemento ni hace avanzar el iterador.
Versión: PHP 8.3
Sintaxis
public function valid(): boolIterator::valid() es un método de instancia sin argumentos que se llama como $iterator->valid(). Devuelve true si hay un elemento en la posición actual y false si no lo hay. No hace avanzar el iterador. null, false y 0 pueden ser valores de elementos válidos.
Cuando foreach usa la interfaz Iterator, PHP empieza llamando a rewind() y luego a valid(). Si el resultado es true, el bucle obtiene el valor con current() y, si hace falta, la clave con key(). Cuando el bucle continúa, next() avanza el iterador y valid() comprueba la nueva posición. Un resultado false termina el recorrido sin leer un elemento en esa posición. Si el iterador está vacío, la primera comprobación devuelve false.
Al recorrer un iterador manualmente, comprueba valid() antes de leer con current() o key(). Si tu implementación usa la posición como clave del array $items, usa array_key_exists($position, $items) en lugar de isset($items[$position]): isset() también devuelve false cuando la clave existe pero su valor es null.
En PHP 8.3, la interfaz Iterator está integrada en PHP y la clase ArrayIterator forma parte de la extensión SPL, que no se puede desactivar.
Ejemplos
<?php
$iterator = new ArrayIterator([null, false, 0]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
var_dump($iterator->current());
}
var_dump($iterator->valid());
Resultado
NULL bool(false) int(0) bool(false)
Las tres primeras líneas son valores de elementos devueltos por `current()`. El `bool(false)` de la segunda línea es el valor de un elemento; solo el último `bool(false)` procede de `valid()` e indica que no hay ningún elemento en la posición actual.
Lecciones relacionadas
- PHP · Lección 61 · Avanzado · Versión: 2
- PHP · Lección 63 · Avanzado · Versión: 2