array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.iterator-count.php', 1 => 'iterator_count', ), 'up' => array ( 0 => 'ref.spl.php', 1 => 'SPL Functions', ), 'prev' => array ( 0 => 'function.iterator-apply.php', 1 => 'iterator_apply', ), 'next' => array ( 0 => 'function.iterator-to-array.php', 1 => 'iterator_to_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/spl/functions/iterator-count.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
iterator_count — Count the elements in an iterator
Count the elements in an iterator.
iterator_count() is not guaranteed to retain the current
position of the iterator
.
iterator
The iterator being counted.
The number of elements in iterator
.
Version | Description |
---|---|
8.2.0 |
The type of iterator has been widened from
Traversable to
Traversable|array.
|
Example #1 iterator_count() example
<?php
$iterator = new ArrayIterator(array('recipe'=>'pancakes', 'egg', 'milk', 'flour'));
var_dump(iterator_count($iterator));
?>
The above example will output:
int(4)
Example #2 iterator_count() modifies position
<?php
$iterator = new ArrayIterator(['one', 'two', 'three']);
var_dump($iterator->current());
var_dump(iterator_count($iterator));
var_dump($iterator->current());
?>
The above example will output:
string(3) "one" int(3) NULL
Example #3 iterator_count() in foreach loops
<?php
$iterator = new ArrayIterator(['one', 'two', 'three']);
foreach ($iterator as $key => $value) {
echo "$key: $value (", iterator_count($iterator), ")\n";
}?>
The above example will output:
0: one (3)