Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / PHP

SplFixedArray::offsetGet — čitanje elementa po indeksu

Pročitaj vrijednost pomoću `offsetGet()` ili `[]` i razlikuj `null` od indeksa izvan dopuštenog raspona ili indeksa nepodržanog tipa.

Verzija: PHP 8.3

Sintaksa

$value = $array->offsetGet($index);
$value = $array[$index];

SplFixedArray::offsetGet metoda je instance koja vraća vrijednost na traženom indeksu. Povratni je tip mixed: pohranjena vrijednost zadržava svoj tip. Zahvaljujući sučelju ArrayAccess, obično čitanje izrazom $array[$index] daje isti rezultat kao $array->offsetGet($index). Klasa je dio SPL-a, koji je ugrađen u PHP 8.3 i ne može se onemogućiti. Unutar imenovanog imenskog prostora upotrijebi \SplFixedArray ili uvezi SplFixedArray.

Indeksi počinju od nule i moraju zadovoljiti uvjet 0 <= $index && $index < $array->getSize(). Čitanje valjanog mjesta kojem nikada nije dodijeljena vrijednost vraća null. Čitanje izričito pohranjenog null daje isti rezultat. Sama povratna vrijednost ne može razlikovati ta dva slučaja.

U PHP-u 8.3 cjelobrojni indeks izvan raspona izaziva RuntimeException, a nepodržan tip indeksa, kao kod niza znakova 'name', izaziva TypeError. Od PHP-a 8.4 pogreška raspona je OutOfBoundsException, podklasa klase RuntimeException. Prije PHP-a 8.1 nepodržani ključevi izazivali su RuntimeException. Provjeri tip i raspon indeksa iz vanjskog unosa umjesto da se oslanjaš na implicitnu pretvorbu: pri čitanju pomoću [] niz znakova '0' može se, primjerice, tretirati kao indeks 0.

Metoda ne vraća referencu na mjesto. Želiš li promijeniti ugniježđeno PHP polje, učitaj ga u varijablu, izmijeni ga i zapiši natrag pomoću $array[$index] = $value ili $array->offsetSet($index, $value).

Primjeri

<?php
$array = new \SplFixedArray(2);
$array[0] = 42;

var_dump($array->offsetGet(0));
var_dump($array[0]);
var_dump($array->offsetGet(1));

foreach ([2, 'name'] as $index) {
    try {
        $array->offsetGet($index);
    } catch (\RuntimeException | \TypeError $error) {
        echo get_class($error), "\n";
    }
}

Rezultat

int(42)
int(42)
NULL
RuntimeException
TypeError

Oba načina čitanja vraćaju `int(42)`. Mjesto bez dodijeljene vrijednosti daje `NULL`, a zadnja dva retka prikazuju očekivane klase iznimaka u PHP-u 8.3.

Povezane lekcije

  • PHP · Lekcija 66 · Napredno · Verzija: 2

Izvori