array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'class.limititerator.php', 1 => 'LimitIterator', 2 => 'A classe LimitIterator', ), 'up' => array ( 0 => 'spl.iterators.php', 1 => 'Iteradores', ), 'prev' => array ( 0 => 'iteratoriterator.valid.php', 1 => 'IteratorIterator::valid', ), 'next' => array ( 0 => 'limititerator.construct.php', 1 => 'LimitIterator::__construct', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/spl/limititerator.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/class.limititerator.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

A classe LimitIterator

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

Introdução

A classe LimitIterator permite a iteração sobre um subconjunto limitado de itens em um Iterator.

Resumo da classe

class LimitIterator extends IteratorIterator {
/* Métodos */
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
/* Métodos herdados */
public IteratorIterator::current(): mixed
public IteratorIterator::getInnerIterator(): ?Iterator
public IteratorIterator::key(): mixed
public IteratorIterator::next(): void
public IteratorIterator::rewind(): void
public IteratorIterator::valid(): bool
}

Exemplos

Exemplo #1 Exemplo de uso de LimitIterator

<?php

// Cria um iterador para ser limitado
$fruits = new ArrayIterator(array(
'apple',
'banana',
'cherry',
'damson',
'elderberry'
));

// Percorre pelas três primeiras frutas somente
foreach (new LimitIterator($fruits, 0, 3) as $fruit) {
var_dump($fruit);
}

echo "\n";

// Percorre a partir da terceira fruta até o final
// Observação: a posição inicia a partir de zero para "apple"
foreach (new LimitIterator($fruits, 2) as $fruit) {
var_dump($fruit);
}

?>

O exemplo acima produzirá:

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

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

Índice