CKTIS / PHP
Iterator::current — ler o valor atual
Lê o valor na posição atual de um iterador sem o fazer avançar. Verifica a posição com `valid()` para não confundir `null` ou `false` com o fim da iteração.
Versão: PHP 8.3
Sintaxe
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current é um método público de instância sem parâmetros que devolve o valor na posição atual do iterador. O tipo de retorno mixed admite qualquer valor de PHP, incluindo null e false. A chamada $iterator->current() não faz avançar o iterador: next() faz com que avance, enquanto key() lê a chave em vez do valor.
Para percorrer manualmente o iterador desde o início, chama rewind() e verifica a posição com valid() após essa chamada e após cada next(), antes de leres um valor. Se valid() devolver false, não chames current(): a interface não especifica o resultado para uma posição inválida. Não detetes o fim da iteração convertendo o valor em bool nem comparando-o com null ou false.
Num ciclo foreach normal sobre um Iterator, o PHP chama rewind() no início e verifica valid() antes de ler o valor através de current(). A forma foreach ($iterator as $key => $value) também lê a chave através de key(). Se o ciclo passar à iteração seguinte, o PHP chama next() e volta a verificar a posição.
Não confundas o método com a função global \current($array), que lê o elemento indicado pelo ponteiro interno de um array. Passar um objeto a essa função é uma prática descontinuada desde o PHP 8.1 e não substitui a chamada ao método do iterador.
Exemplos
<?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));
}
Resultado
a: NULL b: false
Este exemplo não requer nenhuma extensão opcional: `Iterator` faz parte do PHP 8.3 e a SPL não pode ser desativada nessa versão. A classe `\ArrayIterator` da SPL percorre as duas entradas do array pela ordem de inserção. `var_export($value, true)` produz o texto `NULL` ou `false`, tornando visíveis ambos os valores. O ciclo termina quando `valid()` devolve `false`, não quando o valor lido é `false`.
Lições relacionadas
- PHP · Lição 61 · Avançado · Versão: 2
- PHP · Lição 63 · Avançado · Versão: 2