The only difference between CachingIterator and other Iterators such as ArrayIterator is the hasNext() method.
Since the data will be loaded into the memory, the CachingIterator is able to check whether the given iterator has a next element.
Let's demonstrate this by an example:
<?php
$iterator = new CachingIterator(new ArrayIterator(['C', 'C++', 'C#', 'PHP', 'Python', 'Go', 'Ruby']));
foreach ($iterator as $item) {
if ($iterator->hasNext()) {
echo $item.', ';
} else {
echo 'and '.$item;
}
}
// C, C++, C#, PHP, Python, Go, and Ruby
?>
In this example I check whether the iterator has a next value, if so, I append a comma otherwise "and" will be appended to the last element.
A classe CachingIterator
(PHP 5, PHP 7, PHP 8)
Introdução
Este objeto suporta iteração em cache sobre outro iterador.
Resumo da classe
/* Constantes */
/* Métodos */
/* Métodos herdados */
}Constantes pré-definidas
CachingIterator::CALL_TOSTRING-
Converte cada elemento para string.
CachingIterator::CATCH_GET_CHILD-
Não lançar exceção ao acessar filhos.
CachingIterator::TOSTRING_USE_KEY-
Usar key para conversão para string.
CachingIterator::TOSTRING_USE_CURRENT-
Usar current para conversão para string.
CachingIterator::TOSTRING_USE_INNER-
Usar inner para conversão para string.
CachingIterator::FULL_CACHE-
Cache de todos os dados lidos.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.0.0 | CachingIterator implementa Stringable agora. |
Índice
- CachingIterator::__construct — Constrói um novo objeto CachingIterator para o iterador
- CachingIterator::count — O número de elementos no iterador
- CachingIterator::current — Retorna o elemento atual
- CachingIterator::getCache — Recupera o conteúdo do cache
- CachingIterator::getFlags — Obtém as opções utilizadas
- CachingIterator::hasNext — Verifica se o iterador interno possui um próximo elemento válido
- CachingIterator::key — Retorna a chave para o elemento atual
- CachingIterator::next — Move o iterador para frente
- CachingIterator::offsetExists — O propósito do offsetExists
- CachingIterator::offsetGet — O propósito de offsetGet
- CachingIterator::offsetSet — O propósito do offsetSet
- CachingIterator::offsetUnset — O objetivo do offsetUnset
- CachingIterator::rewind — Rebobina o iterador
- CachingIterator::setFlags — O propósito da função setFlags
- CachingIterator::__toString — Retorna a representação em string do elemento atual
- CachingIterator::valid — Verifica se o elemento atual é válido
add a note
User Contributed Notes 4 notes
ahmad dot mayahi at gmail dot com ¶
4 years ago
ahmad dot mayahi at gmail dot com ¶
8 years ago
<?php
//This snippet will print out all the cached elements (foreach) .
$cache = new CachingIterator(new ArrayIterator(range(1,100)), CachingIterator::FULL_CACHE);
foreach ($cache as $c) {
}
print_r($cache->getCache());
?>
jerome at chaman dot ca ¶
4 years ago
"cached iteration over another iterator" means this iterator is always one step behind the inner iterator. In other words, the "first" iteration will yield null:
<?php
$cit = new CachingIterator( new ArrayIterator( [ 'a', 'b', 'c'] ) );
echo $cit->current() ); // null
echo $cit->getInnerIterator()->current() ); // "a"
while($cit->hasNext()){
// we start with a "next" since the "first" item is null
$cit->next();
echo $cit->current(), '<br>';
}
?>
iterating this way gives us an access, ahead, to the future item (aka current item of the inner iterator)
xedin dot unknown at gmail dot com ¶
4 years ago
Apparently, the `FULL_CACHE` flag automatically cancels the default flag `CALL_TOSTRING`. This is evident when one of the values cannot be converted to string: with the default `CALL_TOSTRING` flag, it would throw an error; without that flag, or with the `FULL_CACHE` flag, it does not.
