iterator_apply
Call a function for every element in an iterator
Description
int iterator_apply(Traversable $iterator, callable $callback, arraynull $args = null)
Parameters
-
iterator
-
The iterator object to iterate over.
-
callback
-
The callback function to call on every element.
This function only receives the given args, so it
is nullary by default. If count($args) === 3, for
instance, the callback function is ternary.
Note:
The function must return true in order to
continue iterating over the iterator.
-
args
-
An array of arguments; each element of
args is passed to the callback
callback as separate argument.
Return Values
Returns the iteration count.
Examples
Example #1 iterator_apply example
<?php
function print_caps(Iterator $iterator) {
echo strtoupper($iterator->current()) . "\n";
return TRUE;
}
$it = new ArrayIterator(array("Apples", "Bananas", "Cherries"));
iterator_apply($it, "print_caps", array($it));
?>
The above example will output: