Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 instance

Iterator::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

Fonti