CKTIS / PHP
Iterator::current — прочитане на текущата стойност
Прочетете стойността на текущата позиция на итератора, без да го придвижвате. Проверявайте позицията с `valid()`, за да не объркате стойностите `null` и `false` с края на обхождането.
Версия: PHP 8.3
Синтаксис
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current е публичен метод на обект без параметри, който връща стойността на текущата позиция на итератора. Типът на върнатата стойност mixed допуска всяка стойност в PHP, включително null и false. Извикването на $iterator->current() не придвижва итератора: next() го премества напред, а key() прочита ключа вместо стойността.
За ръчно обхождане от началото извикайте rewind(). След него и след всяко извикване на next() проверявайте позицията с valid(), преди да прочетете стойност. Ако valid() върне false, не извиквайте current(): интерфейсът не определя резултат за невалидна позиция. Не проверявайте за край чрез преобразуване на стойността в bool или сравняване с null или false.
В обикновен цикъл foreach върху обект Iterator PHP извиква rewind() в началото и проверява valid(), преди да прочете стойността чрез current(). Формата foreach ($iterator as $key => $value) прочита и ключа чрез key(). Ако цикълът продължи към следващата итерация, PHP извиква next() и проверява позицията отново.
Не бъркайте метода с глобалната функция \current($array), която прочита елемента, сочен от вътрешния указател на масива. Подаването на обект на тази функция е остаряла употреба от PHP 8.1 насам и не замества извикването на метода на итератора.
Примери
<?php
$iterator = new \ArrayIterator(['a' => null, 'b' => false]);
for ($iterator->rewind(); $iterator->valid(); $iterator->next()) {
$value = $iterator->current();
printf("%s: %s\n", $iterator->key(), var_export($value, true));
}
Резултат
a: NULL b: false
Примерът не изисква допълнително разширение: `Iterator` е вграден в PHP 8.3, а SPL не може да бъде изключена в тази версия. Класът `\ArrayIterator` от SPL обхожда двата елемента на масива в реда на добавянето им. `var_export($value, true)` връща текста `NULL` или `false`, така че и двете стойности се виждат. Цикълът приключва, когато `valid()` върне `false`, а не когато прочетената стойност е `false`.
Свързани уроци
- PHP · Урок 61 · Напреднало · Версия: 2
- PHP · Урок 63 · Напреднало · Версия: 2