iterator_count

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

iterator_countConta os elementos em um iterador

Descrição

iterator_count(Traversable|array $iterator): int

Conta os elementos em um iterador. iterator_count() não garante a manutenção da posição atual do iterator.

Parâmetros

iterator

O iterador sendo contado.

Valor Retornado

O número de elementos em iterator.

Registro de Alterações

Versão Descrição
8.2.0 O tipo de iterator foi ampliado de Traversable para Traversable|array.

Exemplos

Example #1 Exemplo de iterator_count()

<?php
$iterator = new ArrayIterator(array('recipe'=>'pancakes', 'egg', 'milk', 'flour'));
var_dump(iterator_count($iterator));
?>

O exemplo acima produzirá:

int(4)

Example #2 iterator_count() modifica a posição

<?php
$iterator = new ArrayIterator(['one', 'two', 'three']);
var_dump($iterator->current());
var_dump(iterator_count($iterator));
var_dump($iterator->current());
?>

O exemplo acima produzirá:

string(3) "one"
int(3)
NULL

Example #3 iterator_count() em laços foreach

<?php
$iterator = new ArrayIterator(['one', 'two', 'three']);
foreach ($iterator as $key => $value) {
    echo "$key: $value (", iterator_count($iterator), ")\n";
}?>

O exemplo acima produzirá:

0: one (3)