IteratorIterator::getInnerIterator
(PHP 5 >= 5.1.0, PHP 7)
IteratorIterator::getInnerIterator — Получает внутренний итератор
Описание
Получает внутренний итератор.
Список параметров
У этой функции нет параметров.
Возвращаемые значения
Внутренний итератор, который был передан методу IteratorIterator::__construct().
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Другие базовые расширения
- Стандартная библиотека PHP (SPL)
- Итераторы
- Функция IteratorIterator::__construct() - Создает итератор из чего-либо, что является обходимым (traversable)
- Функция IteratorIterator::current() - Получает текущее значение
- Функция IteratorIterator::getInnerIterator() - Получает внутренний итератор
- Функция IteratorIterator::key() - Получает ключ текущего элемента
- Функция IteratorIterator::next() - Перемещает итератор к следующему элементу
- Функция IteratorIterator::rewind() - Возвращает итератор к первому элементу
- Функция IteratorIterator::valid() - Проверяет, является ли итератор допустимым
Коментарии
The returned value from getInnerIterator() really is the inner iterator, not a clone. It should be used with respect: calling next() or rewind() on it, for example, will advance or reset the inner iterator - although the effect won't be noticed until you call next() on the IteratorIterator object - it seems as if it caches its current() and key() values (as of PHP v5.5.9). Even if the inner iterator itself is valid (i.e. valid() returns TRUE) the IteratorIterator won't report itself as valid until you either rewind it or call its next() method - these two methods cause the IteratorIterator to re-sync its current, key and valid states with the inner iterator.
<?php
$ii = new IteratorIterator(new ArrayIterator(range(1,6)));
$i1 = $ii->getInnerIterator(); // gets the real thing
$i2 = $ii->getInnerIterator(); // ditto: $i2 === $i1 and the two are therefore in sync.
echo $i1->current(); // 1
echo $i1->key(); // 0
var_dump($ii->valid()); // FALSE
$i1->next(); // affects $i2, which is identical
echo $i1->key(); // 1
var_dump($ii->valid()); // still FALSE
$ii->rewind(); // rewinds $i1 and synchronizes
echo $ii->key(); // 0, as is $i1->key()
$i1->next(); // advances the inner iterator, which is now out of sync
echo $ii->key(); // still 0
echo $i1->key(); // 1
$ii->next(); // advances the inner iterator and syncs with it
echo $ii->key(); // 2
echo $i1->key(); // 2
?>