php man page for iterator_apply

ITERATOR_APPLY(3)							 1							 ITERATOR_APPLY(3)

iterator_apply - Call a function for every element in an iterator

SYNOPSIS
       int iterator_apply (Traversable	$iterator, callable  $function, [array	$args])

DESCRIPTION
	Calls a function for every element in an iterator.

PARAMETERS
	      o $iterator
		- The class to iterate over.

	      o $function
		- The callback function to call on every element.

	      Note

		      The function must return TRUE in order to continue iterating over the $iterator.

	      o $args
		- Arguments to pass to the callback function.

RETURN VALUES
	Returns the iteration count.

EXAMPLES
       Example #1

	      iterator_apply(3) example

	      <?php
	      function print_caps(Iterator $iterator) {
		  echo strtoupper($iterator->current()) . "
";
		  return TRUE;
	      }

	      $it = new ArrayIterator(array("Apples", "Bananas", "Cherries"));
	      iterator_apply($it, "print_caps", array($it));
	      ?>

	      The above example will output:

	      APPLES
	      BANANAS
	      CHERRIES

SEE ALSO
       array_walk(3).

PHP Documentation Group 													 ITERATOR_APPLY(3)