CKTIS / PHP
SplFixedArray::offsetGet — odczyt elementu według indeksu
Odczytaj wartość z tablicy o ustalonym rozmiarze przez `offsetGet()` lub `[]` i odróżnij `null` od indeksu poza zakresem i niedozwolonego typu indeksu.
Wersja: PHP 8.3
Składnia
$value = $array->offsetGet($index);
$value = $array[$index];SplFixedArray::offsetGet to metoda instancji, która zwraca wartość pod podanym indeksem. Wynik ma typ mixed, więc zachowuje typ zapisanej wartości. Dzięki ArrayAccess zwykły odczyt $array[$index] daje ten sam wynik co $array->offsetGet($index). Klasa należy do SPL, które jest wbudowane w PHP 8.3 i którego nie można wyłączyć. W nazwanej przestrzeni nazw użyj \SplFixedArray lub zaimportuj SplFixedArray.
Indeksy zaczynają się od zera i spełniają warunek 0 <= $index && $index < $array->getSize(). Odczyt prawidłowej pozycji, do której nic nie przypisano, zwraca null. Taki sam wynik daje odczyt jawnie zapisanego null. Sam wynik nie pozwala odróżnić tych dwóch przypadków.
W PHP 8.3 indeks całkowity poza zakresem powoduje RuntimeException, a niedozwolony typ indeksu, np. ciąg 'name', powoduje TypeError. Od PHP 8.4 błąd zakresu to OutOfBoundsException, podklasa RuntimeException. Przed PHP 8.1 niedozwolone klucze powodowały RuntimeException. Sprawdzaj typ i zakres indeksów pochodzących z danych zewnętrznych, zamiast polegać na niejawnej konwersji: np. przy odczycie przez [] ciąg '0' może zostać potraktowany jako indeks 0.
Metoda nie zwraca referencji do pozycji w tablicy. Aby zmienić zagnieżdżoną tablicę PHP, odczytaj ją do zmiennej, zmodyfikuj i zapisz z powrotem przez $array[$index] = $value lub $array->offsetSet($index, $value).
Przykłady
<?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";
}
}
Wynik
int(42) int(42) NULL RuntimeException TypeError
Obie formy odczytu zwracają `int(42)`. Nieuzupełniona pozycja daje `NULL`, a ostatnie dwa wiersze pokazują klasy wyjątków oczekiwane w PHP 8.3.
Powiązane lekcje
- PHP · Lekcja 66 · Zaawansowany · Wersja: 2