PHP 8.4.0 RC2 available for testing

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)

add a note

User Contributed Notes 2 notes

up
3
oleksii dot bulba at gmail dot com
3 years ago
Be aware that counting over NoRewindIterator will make items unavailable:

<?php

$iterator
= new ArrayIterator(['recipe'=>'pancakes', 'egg', 'milk', 'flour']);
$iterator = new NoRewindIterator($iterator);

var_dump($iterator->current());
var_dump(iterator_count($iterator));
var_dump($iterator->current());
$iterator->rewind(); // Does not work because it's NoRewindIterator
var_dump($iterator->current());
var_dump(iterator_count($iterator));

?>

Output:

<?php

/*
string(8) "pancakes"
int(4)
NULL
NULL
*/
int(0)

?>
up
2
info at ensostudio dot ru
3 years ago
Safe using:
<?php
$cnt
= iterator_count(clone $iterator);
?>
To Top