CKTIS / PHP
Iterator::next — avançar para o elemento seguinte
`Iterator::next()` faz avançar um iterador um passo sem devolver o elemento. Ao percorrê-lo manualmente, verifica `valid()` antes de leres o valor com `current()`.
Versão: PHP 8.3
Sintaxe
public function Iterator::next(): void
Instance call: $iterator->next();Iterator::next é um método público de instância da interface Iterator. A chamada $iterator->next() não recebe argumentos e altera a posição do mesmo objeto. Em PHP 8.3, o tipo de retorno void deste método da interface é provisório. O método é diferente da função global \next($array), que avança o ponteiro interno de um array e devolve o valor na nova posição ou false se não houver um elemento seguinte.
Em PHP 8.3, a interface Iterator está integrada e a classe ArrayIterator usada no exemplo faz parte da SPL, que está sempre disponível. Não é necessário ativar nenhuma extensão opcional.
Para percorreres o iterador manualmente, começa por chamar rewind(). Verifica a posição com valid() antes de leres o valor com current() ou a chave com key(). Chama next() depois de processares o elemento. Depois de ultrapassares o último elemento, valid() devolve false: usa esse resultado para detetar o fim, não o valor do elemento nem o resultado de next().
Com um objeto Iterator, foreach chama rewind() no início. Na passagem de uma iteração para a seguinte, chama next() e verifica valid(). Não voltes a chamar next() no corpo do ciclo, a menos que queiras saltar elementos. Um break termina o ciclo sem outro avanço automático.
Exemplos
<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();
while ($iterator->valid()) {
echo $iterator->current(), "\n";
$iterator->next();
}
var_dump($iterator->valid());
Resultado
red blue bool(false)
O exemplo usa `ArrayIterator` da SPL. Mostra primeiro `red` e, após o primeiro avanço, `blue`. Após o segundo avanço, `valid()` devolve `false`, apresentado como `bool(false)`.
Lições relacionadas
- PHP · Lição 61 · Avançado · Versão: 2
- PHP · Lição 63 · Avançado · Versão: 2