Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła