php man page for limititerator

LIMITITERATOR(3)							 1							  LIMITITERATOR(3)

The LimitIterator class

INTRODUCTION
	The LimitIterator class allows iteration over a limited subset of items in an Iterator.

CLASS SYNOPSIS
       LimitIterator

       LimitIteratorextends
       IteratorIteratorOuterIterator

       Methods

       o public LimitIterator::__construct (Iterator  $iterator, [int  $offset], [int  $count = -1])

       o public mixed LimitIterator::current (void  )

       o public Iterator LimitIterator::getInnerIterator (void	)

       o public int LimitIterator::getPosition (void  )

       o public mixed LimitIterator::key (void	)

       o public void LimitIterator::next (void	)

       o public void LimitIterator::rewind (void  )

       o public int LimitIterator::seek (int  $position)

       o public bool LimitIterator::valid (void  )

EXAMPLES
       Example #1

	      LimitIterator usage example

	      <?php

	      // Create an iterator to be limited
	      $fruits = new ArrayIterator(array(
		  'apple',
		  'banana',
		  'cherry',
		  'damson',
		  'elderberry'
	      ));

	      // Loop over first three fruits only
	      foreach (new LimitIterator($fruits, 0, 3) as $fruit) {
		  var_dump($fruit);
	      }

	      echo "
";

	      // Loop from third fruit until the end
	      // Note: offset starts from zero for apple
	      foreach (new LimitIterator($fruits, 2) as $fruit) {
		  var_dump($fruit);
	      }

	      ?>

	      The above example will output:

	      string(5) "apple"
	      string(6) "banana"
	      string(6) "cherry"

	      string(6) "cherry"
	      string(6) "damson"
	      string(10) "elderberry"

PHP Documentation Group 													  LIMITITERATOR(3)