The LimitIterator class

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    Introduction

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

    Class synopsis

    class LimitIterator extends IteratorIterator {
    /* Methods */
    public __construct(Iterator $iterator, int $offset = 0, int $limit = -1)
    public current(): mixed
    public getPosition(): int
    public key(): mixed
    public next(): void
    public rewind(): void
    public seek(int $offset): int
    public valid(): bool
    /* Inherited methods */
    public IteratorIterator::current(): mixed
    public IteratorIterator::getInnerIterator(): ?Iterator
    public IteratorIterator::key(): mixed
    public IteratorIterator::next(): void
    public IteratorIterator::rewind(): void
    public IteratorIterator::valid(): bool
    }

    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     "\n";

    / 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"

    Table of Contents

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 1 note

    up
    1
    christophg at grenz-bonn dot de
    3 years ago
    If the inner iterator implements SeekableIterator, LimitIterator uses seek() after rewind() to move to the offset.
    ＋add a note
    To Top

    Follow Lee on X/Twitter - Father, Husband, Serial builder creating AI, crypto, games & web tools. We are friends :) AI Will Come To Life!

    Check out: eBank.nz (Art Generator) | Netwrck.com (AI Tools) | Text-Generator.io (AI API) | BitBank.nz (Crypto AI) | ReadingTime (Kids Reading) | RewordGame | BigMultiplayerChess | WebFiddle | How.nz | Helix AI Assistant