CKTIS / PHP
Iterator::rewind — връщане на итератора в началото
Цикълът `foreach` извиква `Iterator::rewind()` преди първата проверка с `valid()`. Дали извикването ще върне итератора в началото зависи от реализацията.
Версия: PHP 8.3
Синтаксис
public function rewind(): voidIterator::rewind е публичен метод на инстанцията без параметри и с тип на връщане void. Извикването $it->rewind() поставя итератора на първия елемент, ако има такъв. Методът не връща самия елемент. При ръчно обхождане първо провери valid(), а след това прочети стойността с current() или ключа с key(). Ако итераторът е празен, valid() връща false.
Когато foreach започне да обхожда обект, който реализира Iterator, PHP извиква rewind() преди първата проверка с valid(). Ако обхождането продължи след изпълнението на тялото на цикъла, next() премества итератора, а valid() проверява новата позиция. При приключване на цикъла rewind() не се извиква. При ArrayIterator предварителното ръчно преместване не променя началната позиция на нов цикъл.
Не приемай, че всеки итератор може да се обходи повторно. Generator::rewind() изпълнява генератора до първия yield включително. Ако генераторът вече е там, извикването не прави нищо; ако е продължил след него, хвърля Exception. За да започне цикълът от текущата позиция, обвий итератора в NoRewindIterator: foreach пак извиква rewind(), но обвивката не препраща извикването към вътрешния итератор.
Този метод е различен от rewind($stream), която променя позицията във файлов поток, и от reset($array), която връща вътрешния указател на масив в началото.
Примери
<?php
$items = new ArrayIterator(['a' => 'alpha', 'b' => 'beta']);
$items->next();
echo $items->current(), "\n";
$items->rewind();
echo $items->current(), "\n";
$items->next();
foreach ($items as $key => $value) {
echo $key, '=', $value, "\n";
}
Резултат
beta alpha a=alpha b=beta
`next()` първо премества итератора на `beta`, а изричното извикване на `rewind()` го връща на `alpha`. Следващото `next()` отново го премества на `beta`, но `foreach` започва с `a=alpha`, защото сам извиква `rewind()`.
Свързани уроци
- PHP · Урок 61 · Напреднало · Версия: 2
- PHP · Урок 63 · Напреднало · Версия: 2