Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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(): bool

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

Fontes