CKTIS / PHP
Iterator::current — branje trenutne vrednosti
Preberite vrednost na trenutnem položaju iteratorja, ne da bi ga premaknili. Položaj preverite z `valid()`, da vrednosti `null` ali `false` ne zamenjate za konec iteracije.
Različica: PHP 8.3
Sintaksa
public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instanceIterator::current je javna metoda primerka brez parametrov, ki vrne vrednost na trenutnem položaju iteratorja. Povratni tip mixed dopušča katero koli vrednost PHP, tudi null in false. Klic $iterator->current() iteratorja ne premakne: next() ga premakne naprej, key() pa namesto vrednosti prebere ključ.
Za ročni prehod od začetka pokličite rewind(). Po tem klicu in po vsakem next() preverite položaj z valid(), preden preberete vrednost. Če valid() vrne false, ne kličite current(): vmesnik ne določa rezultata za neveljaven položaj. Konca ne ugotavljajte s pretvorbo vrednosti v bool ali s primerjavo z null ali false.
V običajni zanki foreach nad objektom Iterator PHP na začetku pokliče rewind() in preveri valid(), preden z current() prebere vrednost. Zapis foreach ($iterator as $key => $value) z metodo key() prebere tudi ključ. Če se zanka nadaljuje z naslednjo ponovitvijo, PHP pokliče next() in znova preveri položaj.
Metode ne zamenjajte z globalno funkcijo \current($array), ki prebere element, na katerega kaže notranji kazalec polja. Podajanje objekta tej funkciji je od PHP 8.1 zastarelo in ne nadomesti klica metode iteratorja.
Primeri
<?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));
}
Rezultat
a: NULL b: false
Primer ne zahteva nobene izbirne razširitve: `Iterator` je vgrajen v PHP 8.3, knjižnice SPL pa v tej različici ni mogoče onemogočiti. Razred `\ArrayIterator` iz knjižnice SPL obišče oba elementa polja v vrstnem redu vstavljanja. `var_export($value, true)` ustvari besedilo `NULL` ali `false`, zato sta obe vrednosti vidni. Zanka se konča, ko `valid()` vrne `false`, ne ko je prebrana vrednost `false`.
Povezane lekcije
- PHP · Lekcija 61 · Napredna · Različica: 2
- PHP · Lekcija 63 · Napredna · Različica: 2