(PHP 5 >= 5.1.0, PHP 7, PHP 8)
SeekableIterator::seek — Сдвигает указатель итератора на заданную позицию
Метод сдвигает указатель итератора на позицию, которую указали в аргументе смещения.
offsetПозиция, на которую требуется сдвинуть указатель.
Функция не возвращает значения после выполнения.
К реализациям метода предъявляется требование — выбрасывать
исключение OutOfBoundsException,
если смещение offset выходит за пределы доступного диапазона.
Пример #1 Пример перемещения указателя итератора методом SeekableIterator::seek()
Перемещение к элементу на 3-й позиции итератора; класс ArrayIterator реализует интерфейс SeekableIterator.
<?php
$array = array("яблоко", "банан", "вишня", "чернослив", "ягода бузины");
$iterator = new ArrayIterator($array);
$iterator->seek(3);
echo $iterator->current();
?>Вывод приведённого примера будет похож на:
чернослив