Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

Iterator::current — čítanie aktuálnej hodnoty

Prečítajte hodnotu na aktuálnej pozícii iterátora bez toho, aby ste ho posunuli. Pozíciu overte pomocou `valid()`, aby ste si hodnoty `null` a `false` nezamenili s koncom iterácie.

Verzia: PHP 8.3

Syntax

public function current(): mixed; // declaration inside an interface
$value = $iterator->current(); // call on an Iterator instance

Iterator::current je verejná inštančná metóda bez parametrov, ktorá vracia hodnotu na aktuálnej pozícii iterátora. Návratový typ mixed pripúšťa ľubovoľnú hodnotu PHP vrátane null a false. Volanie $iterator->current() iterátor neposúva: posun vykonáva next(), kým key() číta kľúč namiesto hodnoty.

Pri ručnom prechode od začiatku zavolajte rewind() a po ňom aj po každom next() overte pozíciu metódou valid(), skôr než prečítate hodnotu. Ak valid() vráti false, nevolajte current(): rozhranie neurčuje výsledok pre neplatnú pozíciu. Koniec nezisťujte prevodom hodnoty na bool ani porovnaním s null alebo false.

V bežnom cykle foreach nad objektom Iterator PHP na začiatku zavolá rewind() a skontroluje valid() skôr, než prečíta hodnotu pomocou current(). Zápis foreach ($iterator as $key => $value) načíta pomocou key() aj kľúč. Ak cyklus pokračuje ďalšou iteráciou, PHP zavolá next() a pozíciu overí znova.

Nezamieňajte túto metódu s globálnou funkciou \current($array), ktorá číta prvok označený interným ukazovateľom poľa. Odovzdávanie objektu tejto funkcii je od PHP 8.1 zastarané a nenahrádza volanie metódy iterátora.

Príklady

<?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));
}

Výsledok

a: NULL
b: false

Príklad nevyžaduje žiadne voliteľné rozšírenie: `Iterator` je súčasťou PHP 8.3 a knižnicu SPL v tejto verzii nemožno vypnúť. Trieda `\ArrayIterator` z knižnice SPL prejde dve položky poľa v poradí vloženia. `var_export($value, true)` vytvorí text `NULL` alebo `false`, takže sú obe hodnoty viditeľné. Cyklus sa skončí, keď `valid()` vráti `false`, nie keď je prečítaná hodnota `false`.

Súvisiace lekcie

  • PHP · Lekcia 61 · Pokročilá · Verzia: 2
  • PHP · Lekcia 63 · Pokročilá · Verzia: 2

Zdroje