Подсчитывает количество элементов в итераторе

# iterator_count

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

iterator_count — Подсчитывает количество элементов в итераторе

### Описание

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

Функция подсчитывает количество элементов в итераторе. Функция iterator_count() не гарантирует сохранение текущей позиции итератора `iterator`.

### Список параметров

`iterator`

  Итератор, в котором функция подсчитывает элементы.

### Возвращаемые значения

Функция возвращает количество элементов в итераторе `iterator`.

### Список изменений

Версия | Описание
--- | ---
8.2.0 | Тип параметра `iterator` расширили с Traversable до Traversable|array.

### Примеры

Пример #1 Пример использования функции iterator_count()

    <?php

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

    ?>

Результат выполнения приведённого примера:

    int(4)

Пример #2 Пример изменения позиции итератора функцией iterator_count()

    <?php

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

    ?>

Результат выполнения приведённого примера:

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

Пример #3 Пример работы функции iterator_count() в цикле `foreach`

    <?php

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

    ?>

Результат выполнения приведённого примера:

    0: one (3)

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