LimitIterator::__construct

Construct a LimitIterator

&reftitle.description; public `LimitIterator::__construct` `Iterator` `iterator` `int` `offset` 0 `int` `limit`-1

Constructs a new `LimitIterator` from an `iterator` with a given starting `offset` and maximum `limit`.

&reftitle.parameters;

`iterator`

- The `Iterator` to limit.

`offset`

- Optional offset of the limit.

`limit`

- Optional count of the limit.

&reftitle.errors;

Throws a `ValueError` if the `offset` is less than `0` or the `limit` is less than `-1`.

&reftitle.changelog;

&Version; | &Description;
8.0.0 | Now throws a `ValueError` if `offset` is less than `0`; previously it threw a `RuntimeException`.
8.0.0 | Now throws a `ValueError` if `limit` is less than `-1`; previously it threw a `RuntimeException`.

&reftitle.examples;

### `LimitIterator::__construct` example

    <?php
    $ait = new ArrayIterator(array('a', 'b', 'c', 'd', 'e'));
    $lit = new LimitIterator($ait, 1, 3);
    foreach ($lit as $value) {
        echo $value . "\n";
    }
    ?>

&example.outputs;

    b
    c
    d

&reftitle.seealso;

- LimitIterator examples