CKTIS / PHP
SplFixedArray::offsetGet — čtení prvku podle indexu
Přečti hodnotu pomocí `offsetGet()` nebo `[]` a rozliš hodnotu `null` od indexu mimo povolený rozsah nebo indexu nepodporovaného typu.
Verze: PHP 8.3
Syntaxe
$value = $array->offsetGet($index);
$value = $array[$index];SplFixedArray::offsetGet je instanční metoda, která vrací hodnotu na požadovaném indexu. Návratový typ je mixed: uložená hodnota si zachovává svůj typ. Díky ArrayAccess dává běžné čtení přes $array[$index] stejný výsledek jako $array->offsetGet($index). Třída patří do SPL, která je vestavěnou součástí PHP 8.3 a nelze ji vypnout. V pojmenovaném jmenném prostoru použij \SplFixedArray nebo importuj SplFixedArray.
Indexy začínají nulou a musí splňovat 0 <= $index && $index < $array->getSize(). Čtení platné pozice, do které dosud nebyla přiřazena žádná hodnota, vrací null. Čtení výslovně uložené hodnoty null dává stejný výsledek. Ze samotné návratové hodnoty tyto případy nerozlišíš.
V PHP 8.3 vyvolá celočíselný index mimo rozsah RuntimeException; nepodporovaný typ indexu, například u řetězce 'name', vyvolá TypeError. Od PHP 8.4 se při překročení rozsahu vyvolává OutOfBoundsException, která je podtřídou RuntimeException. Před PHP 8.1 vyvolávaly nepodporované klíče RuntimeException. U indexů z externího vstupu ověřuj typ a rozsah místo spoléhání na implicitní převod: při čtení přes [] se například řetězec '0' může použít jako index 0.
Metoda nevrací referenci na pozici. Chceš-li změnit vnořené pole PHP, načti ho do proměnné, uprav ho a zapiš zpět pomocí $array[$index] = $value nebo $array->offsetSet($index, $value).
Pří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ýsledek
int(42) int(42) NULL RuntimeException TypeError
Oba zápisy pro čtení vracejí `int(42)`. Pozice bez přiřazené hodnoty dává `NULL` a poslední dva řádky ukazují třídy výjimek očekávané v PHP 8.3.
Související lekce
- PHP · Lekce 66 · Pokročilá · Verze: 2