CKTIS / PHP
Iterator::current — leggere il valore corrente
Leggi il valore nella posizione corrente di un iteratore senza farlo avanzare. Controlla la posizione con `valid()` per non confondere `null` o `false` con la fine dell’iterazione.
Versione: PHP 8.3
Sintassi
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current è un metodo pubblico di istanza senza parametri che restituisce il valore nella posizione corrente dell’iteratore. Il tipo di ritorno mixed ammette qualunque valore PHP, compresi null e false. La chiamata $iterator->current() non fa avanzare l’iteratore: next() lo fa avanzare, mentre key() legge la chiave anziché il valore.
Per scorrere manualmente l’iteratore dall’inizio, chiama rewind() e controlla la posizione con valid() dopo questa chiamata e dopo ogni next(), prima di leggere un valore. Se valid() restituisce false, non chiamare current(): l’interfaccia non specifica il risultato per una posizione non valida. Non rilevare la fine convertendo il valore in bool o confrontandolo con null o false.
In un normale ciclo foreach su un Iterator, PHP chiama rewind() all’inizio e controlla valid() prima di leggere il valore tramite current(). La forma foreach ($iterator as $key => $value) legge anche la chiave tramite key(). Se il ciclo prosegue con l’iterazione successiva, PHP chiama next() e controlla di nuovo la posizione.
Non confondere il metodo con la funzione globale \current($array), che legge l’elemento indicato dal puntatore interno di un array. Passare un oggetto a quella funzione è deprecato da PHP 8.1 e non sostituisce la chiamata al metodo dell’iteratore.
Esempi
<?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));
}
Risultato
a: NULL b: false
Questo esempio non richiede estensioni facoltative: `Iterator` è integrato in PHP 8.3 e SPL non si può disattivare in quella versione. La classe SPL `\ArrayIterator` visita le due voci dell’array nell’ordine di inserimento. `var_export($value, true)` produce il testo `NULL` o `false`, rendendo visibili entrambi i valori. Il ciclo termina quando `valid()` restituisce `false`, non quando il valore letto è `false`.
Lezioni correlate
- PHP · Lezione 61 · Avanzato · Versione: 2
- PHP · Lezione 63 · Avanzato · Versione: 2