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