iterator_count
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
iterator_count — Conta os elementos em um iterador
Descrição
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)