Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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

Izvori