CKTIS / PHP
Iterator::valid — Verificar a posição atual do iterador
`Iterator::valid()` indica se existe um elemento na posição atual do iterador. O método não avalia o valor desse elemento nem faz avançar o iterador.
Versão: PHP 8.3
Sintaxe
public function valid(): boolIterator::valid() é um método de instância sem argumentos, chamado como $iterator->valid(). Devolve true quando existe um elemento na posição atual e false quando não existe. Não faz avançar o iterador. null, false e 0 podem ser valores de elementos válidos.
Quando foreach usa a interface Iterator, o PHP começa por chamar rewind() e depois valid(). Se o resultado for true, o ciclo obtém o valor com current() e, se necessário, a chave com key(). Quando o ciclo prossegue, next() faz avançar o iterador e valid() verifica a nova posição. Um resultado false termina a iteração sem ler um elemento nessa posição. Se o iterador estiver vazio, a primeira verificação devolve false.
Ao percorrer um iterador manualmente, verifica valid() antes de ler com current() ou key(). Se a tua implementação usar a posição como chave no array $items, usa array_key_exists($position, $items) em vez de isset($items[$position]): isset() também devolve false quando a chave existe mas o seu valor é null.
No PHP 8.3, a interface Iterator está integrada no PHP e a classe ArrayIterator faz parte da extensão SPL, que não pode ser desativada.
Exemplos
<?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)
As três primeiras linhas apresentam os valores dos elementos devolvidos por `current()`. O `bool(false)` da segunda linha é o valor de um elemento; só o último `bool(false)` vem de `valid()` e indica que não há nenhum elemento na posição atual.
Lições relacionadas
- PHP · Lição 61 · Avançado · Versão: 2
- PHP · Lição 63 · Avançado · Versão: 2