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