Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

SplFixedArray::offsetSet — zapis wartości pod indeksem

Zapisz lub zastąp wartość w tablicy o stałym rozmiarze. Porównaj bezpośrednie wywołanie metody z przypisaniem przez nawiasy kwadratowe i rozróżnij błędy indeksu w PHP 8.3.

Wersja: PHP 8.3

Składnia

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

SplFixedArray::offsetSet zapisuje wartość w istniejącej pozycji obiektu \SplFixedArray, klasy SPL z globalnej przestrzeni nazw. SPL jest częścią rdzenia PHP i jest zawsze włączona w standardowych kompilacjach PHP 8.3. $array->offsetSet($index, $value) i $array[$index] = $value zapisują wartość w tej samej pozycji, jeśli indeks jest poprawną liczbą całkowitą. Wartość może mieć dowolny typ (mixed), także null. Metoda zmienia obiekt i nie zwraca wartości (void).

Poprawny indeks spełnia warunek 0 <= $index && $index < $array->getSize(). Przy rozmiarze 2 można zapisywać pod indeksami 0 i 1, ale nie pod 2. Zapis nie zmienia rozmiaru, a $array[] = $value nie dopisuje elementu jak w zwykłej tablicy PHP. Aby uzyskać więcej pozycji, najpierw wywołaj setSize(), a potem zapisz wartość pod konkretnym indeksem.

W PHP 8.3 całkowity indeks spoza zakresu powoduje RuntimeException, a niedozwolony klucz, taki jak 'label', powoduje TypeError. Od PHP 8.4 konkretną klasą wyjątku dla indeksu spoza zakresu jest OutOfBoundsException, podklasa RuntimeException. Jeśli indeks pochodzi z zewnątrz, sprawdź is_int($index) i zakres zamiast polegać na niejawnej konwersji.

Przykłady

<?php
$array = new \SplFixedArray(2);

$array->offsetSet(1, 'draft');
echo $array[1], "\n";

$array[1] = 'ready';
echo $array[1], "\n";

try {
    $array->offsetSet(2, 'extra');
} catch (\RuntimeException $error) {
    echo get_class($error), "\n";
}

try {
    $array['label'] = 'extra';
} catch (\TypeError $error) {
    echo get_class($error), "\n";
}

Wynik

draft
ready
RuntimeException
TypeError

Skrypt najpierw zapisuje `draft` pod indeksem 1 za pomocą metody, a następnie zastępuje tę wartość przez `ready` za pomocą nawiasów kwadratowych. Na końcu wypisuje nazwy klas zgłoszonych osobno dla indeksu 2 i klucza `'label'`.

Powiązane lekcje

  • PHP · Lekcja 66 · Zaawansowany · Wersja: 2

Źródła