CKTIS / PHP
Iterator::key — Čitanje ključa trenutačnog elementa
Pročitaj ključ trenutačnog elementa bez pomicanja iteratora i pogledaj kako PHP dodjeljuje taj ključ u petlji `foreach`.
Verzija: PHP 8.3
Sintaksa
public function key(): mixed
$iterator->key();Iterator::key javna je metoda instance bez parametara. Pozivom $iterator->key() čitaš ključ na trenutačnom položaju bez pomicanja iteratora. current() čita vrijednost na istom položaju, next() pomiče iterator naprijed, a rewind() vraća ga na početak.
U petlji foreach ($iterator as $key => $value) PHP na početku poziva rewind() i prije svakog prolaza provjerava položaj metodom valid(). Na valjanom položaju čita vrijednost metodom current() i ključ metodom key(). Nakon redovitog dovršetka tijela petlje poziva next(). Pri ručnom prolasku provjeri valid() umjesto samog ključa: 0 može biti valjan ključ.
Povratni tip mixed ne ograničava ključeve na int i string: primjerice, MultipleIterator::key() vraća niz. ArrayIterator::key() ima uži potpis: string|int|null. Priručnik za sučelje navodi null i E_NOTICE u slučaju neuspjeha, ali nemoj pretpostaviti da se svaka implementacija tako ponaša na nevaljanom položaju. U PHP-u 8.3 u svojoj implementaciji deklariraj public function key(): mixed ili kompatibilan uži povratni tip da izbjegneš obavijest o zastarjelom potpisu.
Nemoj zamijeniti ovu metodu s globalnom funkcijom \key($array), koja čita ključ prema unutarnjem pokazivaču niza. Prosljeđivanje objekta toj funkciji označeno je kao zastarjelo od PHP-a 8.1.
Primjeri
<?php
$iterator = new \ArrayIterator([0 => 'oak', 'tree' => 'pine']);
$iterator->rewind();
if ($iterator->valid()) {
echo $iterator->key(), ', ', $iterator->key(), "\n";
}
$iterator->next();
if ($iterator->valid()) {
echo $iterator->key(), "\n";
}
foreach ($iterator as $key => $value) {
echo $key, ' => ', $value, "\n";
}
Rezultat
0, 0 tree 0 => oak tree => pine
Primjer koristi `\ArrayIterator` iz SPL-a. Oba čitanja vraćaju `0`; tek `next()` pomiče iterator na `tree`. Petlja `foreach` kreće od početka i ispisuje oba para.
Povezane lekcije
- PHP · Lekcija 61 · Napredno · Verzija: 2
- PHP · Lekcija 63 · Napredno · Verzija: 2