Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / PHP

SplFixedArray::offsetGet — čítanie prvku podľa indexu

Prečítaj hodnotu pomocou `offsetGet()` alebo `[]` a odlíš hodnotu `null` od indexu mimo povoleného rozsahu či indexu nepodporovaného typu.

Verzia: PHP 8.3

Syntax

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

SplFixedArray::offsetGet je inštančná metóda, ktorá vráti hodnotu na požadovanom indexe. Návratový typ je mixed: uložená hodnota si zachová svoj typ. Vďaka ArrayAccess dá obyčajné čítanie cez $array[$index] rovnaký výsledok ako $array->offsetGet($index). Trieda patrí do SPL, ktorá je zabudovaná v PHP 8.3 a nedá sa vypnúť. V pomenovanom mennom priestore použi \SplFixedArray alebo importuj SplFixedArray.

Indexy sa začínajú nulou a musia spĺňať 0 <= $index && $index < $array->getSize(). Čítanie platnej pozície, ktorej ešte nebola priradená žiadna hodnota, vráti null. Čítanie výslovne uloženého null dá rovnaký výsledok. Samotná návratová hodnota tieto prípady nerozlíši.

V PHP 8.3 celočíselný index mimo rozsahu vyvolá RuntimeException; nepodporovaný typ indexu, napríklad pri reťazci 'name', vyvolá TypeError. Od PHP 8.4 sa pri prekročení rozsahu vyvoláva OutOfBoundsException, podtrieda RuntimeException. Pred PHP 8.1 vyvolávali nepodporované kľúče RuntimeException. Pri indexoch z externého vstupu overuj typ aj rozsah namiesto spoliehania sa na implicitnú konverziu: pri čítaní cez [] sa napríklad reťazec '0' môže použiť ako index 0.

Metóda nevracia referenciu na pozíciu. Ak chceš zmeniť vnorené pole PHP, načítaj ho do premennej, uprav ho a zapíš späť pomocou $array[$index] = $value alebo $array->offsetSet($index, $value).

Príklady

<?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";
    }
}

Výsledok

int(42)
int(42)
NULL
RuntimeException
TypeError

Oba zápisy na čítanie vracajú `int(42)`. Pozícia bez priradenej hodnoty vráti `NULL` a posledné dva riadky ukazujú triedy výnimiek očakávané v PHP 8.3.

Súvisiace lekcie

  • PHP · Lekcia 66 · Pokročilá · Verzia: 2

Zdroje