CKTIS / PHP
Iterator::current — wartość bieżącego elementu
Odczytaj wartość elementu na bieżącej pozycji iteratora bez przesuwania go. Sprawdzaj pozycję za pomocą `valid()`, aby nie pomylić wartości `null` ani `false` z końcem iteracji.
Wersja: PHP 8.3
Składnia
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current to publiczna metoda instancji bez parametrów, która zwraca wartość elementu na bieżącej pozycji iteratora. Typ mixed dopuszcza każdą wartość PHP, w tym null i false. Wywołanie $iterator->current() nie przesuwa iteratora: next() przesuwa go dalej, a key() odczytuje klucz zamiast wartości.
Przy ręcznym przechodzeniu od początku wywołaj rewind(), a po nim i po każdym next() sprawdź valid(), zanim odczytasz wartość. Jeśli valid() zwraca false, nie wywołuj current(): interfejs nie określa wyniku dla nieprawidłowej pozycji. Nie sprawdzaj końca iteracji przez konwersję wartości na bool ani porównanie jej z null lub false.
W zwykłej pętli foreach nad obiektem Iterator PHP wywołuje rewind() na początku i sprawdza valid() przed odczytaniem wartości przez current(). Zapis foreach ($iterator as $key => $value) pobiera także klucz przez key(). Jeśli pętla przechodzi do następnej iteracji, PHP wywołuje next() i ponownie sprawdza pozycję.
Nie myl metody z globalną funkcją \current($array), która odczytuje element wskazywany przez wewnętrzny wskaźnik tablicy. Przekazywanie obiektu do tej funkcji jest przestarzałe od PHP 8.1 i nie zastępuje wywołania metody iteratora.
Przykłady
<?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));
}
Wynik
a: NULL b: false
Przykład nie wymaga opcjonalnego rozszerzenia: `Iterator` jest wbudowany w PHP 8.3, a biblioteki SPL nie można w tej wersji wyłączyć. Klasa `\ArrayIterator` z SPL przechodzi po dwóch wpisach tablicy w kolejności wstawienia. `var_export($value, true)` daje tekst `NULL` lub `false`, więc obie wartości są widoczne. Pętla kończy się, gdy `valid()` zwraca `false`, a nie wtedy, gdy odczytana wartość to `false`.
Powiązane lekcje
- PHP · Lekcja 61 · Zaawansowany · Wersja: 2
- PHP · Lekcja 63 · Zaawansowany · Wersja: 2