Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / PHP

Iterator::valid — Verificare la posizione corrente dell’iteratore

`Iterator::valid()` indica se nella posizione corrente dell’iteratore è presente un elemento. Il metodo non valuta il valore dell’elemento e non fa avanzare l’iteratore.

Versione: PHP 8.3

Sintassi

public function valid(): bool

Iterator::valid() è un metodo di istanza senza argomenti, da chiamare come $iterator->valid(). Restituisce true se nella posizione corrente è presente un elemento e false se non lo è. Non fa avanzare l’iteratore. Anche null, false e 0 possono essere valori di elementi validi.

Quando foreach usa l’interfaccia Iterator, PHP chiama prima rewind() e poi valid(). Se il risultato è true, il ciclo legge il valore con current() e, se serve, la chiave con key(). Quando il ciclo prosegue, next() fa avanzare l’iteratore e valid() controlla la nuova posizione. Un risultato false termina l’iterazione senza leggere un elemento in quella posizione. Se l’iteratore è vuoto, il primo controllo restituisce false.

Durante l’iterazione manuale, controlla valid() prima di leggere con current() o key(). Se la tua implementazione usa la posizione come chiave nell’array $items, usa array_key_exists($position, $items) anziché isset($items[$position]): isset() restituisce false anche quando la chiave esiste ma il suo valore è null.

In PHP 8.3, l’interfaccia Iterator è integrata in PHP e la classe ArrayIterator è fornita dall’estensione SPL, che non può essere disattivata.

Esempi

<?php

$iterator = new ArrayIterator([null, false, 0]);

for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
    var_dump($iterator->current());
}

var_dump($iterator->valid());

Risultato

NULL
bool(false)
int(0)
bool(false)

Le prime tre righe mostrano i valori degli elementi restituiti da `current()`. Il `bool(false)` della seconda riga è il valore di un elemento; solo l’ultimo `bool(false)` proviene da `valid()` e indica che nella posizione corrente non c’è alcun elemento.

Lezioni correlate

  • PHP · Lezione 61 · Avanzato · Versione: 2
  • PHP · Lezione 63 · Avanzato · Versione: 2

Fonti