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