Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / PHP

SplFixedArray::offsetGet — branje elementa po indeksu

Preberi vrednost z `offsetGet()` ali `[]` in loči `null` od indeksa zunaj dovoljenega območja ali indeksa nepodprtega tipa.

Različica: PHP 8.3

Sintaksa

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

SplFixedArray::offsetGet je instančna metoda, ki vrne vrednost na zahtevanem indeksu. Vračilni tip je mixed: shranjena vrednost ohrani svoj tip. Zaradi vmesnika ArrayAccess preprosto branje z $array[$index] da enak rezultat kot $array->offsetGet($index). Razred je del knjižnice SPL, ki je vgrajena v PHP 8.3 in je ni mogoče izklopiti. V poimenovanem imenskem prostoru uporabi \SplFixedArray ali uvozi SplFixedArray.

Indeksi se začnejo pri nič in morajo izpolnjevati pogoj 0 <= $index && $index < $array->getSize(). Če veljavnemu mestu še ni bila dodeljena vrednost, branje vrne null. Branje izrecno shranjene vrednosti null da enak rezultat. Samo iz vrnjene vrednosti teh primerov ne moreš ločiti.

V PHP 8.3 celoštevilski indeks zunaj območja sproži RuntimeException, nepodprt tip indeksa, kot je pri nizu 'name', pa sproži TypeError. Od PHP 8.4 naprej je izjema pri prekoračitvi območja OutOfBoundsException, podrazred RuntimeException. Pred PHP 8.1 so nepodprti ključi sprožili RuntimeException. Pri indeksih iz zunanjega vnosa preveri tip in območje, namesto da se zanašaš na implicitno pretvorbo: ob branju z [] se lahko na primer niz '0' obravnava kot indeks 0.

Metoda ne vrne reference na mesto. Če želiš spremeniti ugnezdeno polje PHP, ga preberi v spremenljivko, spremeni in zapiši nazaj z $array[$index] = $value ali $array->offsetSet($index, $value).

Primeri

<?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 branja vrneta `int(42)`. Mesto brez dodeljene vrednosti vrne `NULL`, zadnji dve vrstici pa prikažeta razreda izjem, pričakovana v PHP 8.3.

Povezane lekcije

  • PHP · Lekcija 66 · Napredna · Različica: 2

Viri