Cuenta el número de elementos en un iterador

# iterator_count

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

iterator_count — Cuenta el número de elementos en un iterador

### Descripción

function iterator_count(Traversable|array `$iterator`): int

Cuenta los elementos en un iterador. No se garantiza que la función iterator_count() conserve la posición actual del iterador `iterator`.

### Parámetros

`iterator`

  El iterador del cual contar los elementos.

### Valores devueltos

El número de elementos en el iterador `iterator`.

### Historial de cambios

Versión | Descripción
--- | ---
8.2.0 | El tipo de `iterator` ha sido ampliado de Traversable a Traversable|array.

### Ejemplos

Ejemplo #1 Ejemplo con iterator_count()

    <?php
    $iterator = new ArrayIterator(array('recipe'=>'crêpes', 'oeufs', 'lait', 'farine'));
    var_dump(iterator_count($iterator));
    ?>

El ejemplo anterior mostrará:

    int(4)

Ejemplo #2 Ejemplo con iterator_count() que modifica la posición

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

El ejemplo anterior mostrará:

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

Ejemplo #3 Ejemplo con iterator_count() en un ciclo `foreach`

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

El ejemplo anterior mostrará:

    0: one (3)

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