iterator_count

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

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

    Описание

    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)
    To Top