Conta os elementos em um iterador

# iterator_count

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

iterator_count — Conta os elementos em um iterador

### Descrição

function 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

Exemplo #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)

Exemplo #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

Exemplo #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)

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open