PHP マニュアル: LimitIterator を作成する

説明

public LimitIterator::__construct(Iterator $iterator, int $offset = 0, int $limit = -1)

開始位置 offset と最大数 limit を指定したイテレータ iterator から新しい LimitIterator を作成します。

パラメータ

iterator: 制限したいイテレータ。
offset: オプションの開始位置。
limit: オプションの要素数。

エラー / 例外

offset が 0 未満、あるいは limit が -1 未満の場合に ValueError をスローします。

変更履歴

バージョン	説明
8.0.0	`offset` が `0` 未満の場合に、ValueError をスローするようになりました。これより前のバージョンでは、 RuntimeException をスローしていました。
8.0.0	`limit` が `-1` 未満の場合に、 ValueError をスローするようになりました。これより前のバージョンでは、 RuntimeException をスローしていました。

例

例1 LimitIterator::__construct の例

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

上の例の出力は以下となります。

b
c
d

参考

LimitIterator の例