Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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 instance

Iterator::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

Viri