Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / PHP

Iterator::current — leer el valor actual

Lee el valor en la posición actual de un iterador sin hacerlo avanzar. Comprueba la posición con `valid()` para no confundir `null` o `false` con el final de la iteración.

Versión: PHP 8.3

Sintaxis

public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instance

Iterator::current es un método público de instancia sin parámetros que devuelve el valor en la posición actual del iterador. El tipo de retorno mixed admite cualquier valor de PHP, incluidos null y false. La llamada $iterator->current() no hace avanzar el iterador: next() lo hace avanzar y key() lee la clave en lugar del valor.

Para recorrer el iterador manualmente desde el principio, llama a rewind() y comprueba la posición con valid() después de esa llamada y de cada next(), antes de leer un valor. Si valid() devuelve false, no llames a current(): la interfaz no especifica el resultado para una posición no válida. No detectes el final convirtiendo el valor a bool ni comparándolo con null o false.

En un bucle foreach normal sobre un Iterator, PHP llama a rewind() al principio y comprueba valid() antes de leer el valor mediante current(). La forma foreach ($iterator as $key => $value) también lee la clave mediante key(). Si el bucle pasa a la siguiente iteración, PHP llama a next() y vuelve a comprobar la posición.

No confundas el método con la función global \current($array), que lee el elemento señalado por el puntero interno de un array. Pasar un objeto a esa función está obsoleto desde PHP 8.1 y no sustituye a la llamada al método del iterador.

Ejemplos

<?php
$iterator = new \ArrayIterator(['a' => null, 'b' => false]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    $value = $iterator->current();
    printf("%s: %s\n", $iterator->key(), var_export($value, true));
}

Resultado

a: NULL
b: false

Este ejemplo no requiere ninguna extensión opcional: `Iterator` está integrado en PHP 8.3 y SPL no se puede desactivar en esa versión. La clase `\ArrayIterator` de SPL recorre las dos entradas del array en el orden de inserción. `var_export($value, true)` produce el texto `NULL` o `false`, de modo que ambos valores son visibles. El bucle termina cuando `valid()` devuelve `false`, no cuando el valor leído es `false`.

Lecciones relacionadas

  • PHP · Lección 61 · Avanzado · Versión: 2
  • PHP · Lección 63 · Avanzado · Versión: 2

Fuentes