PHP 8.1.0 RC 2 available for testing

iterator_count

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

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

Описание

iterator_count(Traversable $iterator): int

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

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

iterator

Итератор, в котором производится подсчёт.

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

Количество элементов в итераторе (iterator).

Примеры

Пример #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 add a note

User Contributed Notes 3 notes

up
2
fractile81 at gmail dot com
1 year ago
After using this function, the traversable's pointer will point at the end.  Examples 2 and 3 highlight this using code.

This means that when you call iterator_count($foo)...
- Before a foreach-loop on $foo, the loop will not execute because it's already at the end.  Calling $foo->rewind() will reset the traversable to the beginning.
- Inside a foreach-loop on $foo, the loop will complete the current iteration and not repeat.  Something like $foo->seek($i) can be used to reset the pointer, where $i contains the pointer's value prior to counting.
up
0
oleksii dot bulba at gmail dot com
19 days 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
0
info at ensostudio dot ru
11 months ago
Safe using:
<?php
$cnt
= iterator_count(clone $iterator);
?>
To Top