База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / PHP

Iterator::next — преминаване към следващия елемент

`Iterator::next()` премества итератора с една стъпка, без да връща елемента. При ръчно обхождане провери позицията с `valid()`, преди да прочетеш стойността с `current()`.

Версия: PHP 8.3

Синтаксис

public function Iterator::next(): void

Instance call: $iterator->next();

Iterator::next е публичен метод на екземпляр от интерфейса Iterator. Извикването $iterator->next() не приема аргументи и променя позицията на същия обект. В PHP 8.3 типът на връщане void за този метод на интерфейса е деклариран предварително (tentative return type). Методът е различен от глобалната функция \next($array), която премества вътрешния указател на масив и връща стойността на новата позиция или false, ако няма следващ елемент.

В PHP 8.3 интерфейсът Iterator е вграден, а класът ArrayIterator от примера е част от SPL, която е винаги налична. Не е необходимо да се включва допълнително разширение.

Започни ръчното обхождане с rewind(). Провери позицията с valid(), преди да прочетеш стойността с current() или ключа с key(). Извикай next() след обработката на елемента. След преминаване отвъд последния елемент valid() връща false. Разпознавай края по този резултат, а не по стойността на елемента или резултата от next().

При обект от тип Iterator цикълът foreach извиква rewind() в началото. При преминаване към следващата итерация той извиква next() и проверява valid(). Не извиквай next() допълнително в тялото на цикъла, освен ако искаш да пропуснеш елементи. break прекратява цикъла без още едно автоматично преместване.

Примери

<?php
$iterator = new \ArrayIterator(['red', 'blue']);
$iterator->rewind();

while ($iterator->valid()) {
    echo $iterator->current(), "\n";
    $iterator->next();
}

var_dump($iterator->valid());

Резултат

red
blue
bool(false)

Примерът използва `ArrayIterator` от SPL. Първо извежда `red`, а след първото преместване — `blue`. След второто преместване `valid()` връща `false`, което се извежда като `bool(false)`.

Свързани уроци

  • PHP · Урок 61 · Напреднало · Версия: 2
  • PHP · Урок 63 · Напреднало · Версия: 2

Източници