CKTIS / PHP
Zmiana rozmiaru tablicy za pomocą SplFixedArray::setSize
Zmień rozmiar istniejącej tablicy `SplFixedArray`. Zwiększenie rozmiaru dodaje pozycje z `null`, a zmniejszenie usuwa wartości z końca tablicy.
Wersja: PHP 8.3
Składnia
PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.SplFixedArray::setSize zmienia rozmiar istniejącego obiektu SPL, zamiast tworzyć nowy. To metoda instancji: wywołaj ją jako $array->setSize($size). Argument $size typu int oznacza docelową liczbę pozycji, a nie przyrost ani ostatni indeks. Przy dodatnim rozmiarze indeksy mieszczą się w zakresie od 0 do $size - 1.
Zwiększenie rozmiaru zachowuje dotychczasowe wartości i wypełnia nowe pozycje wartością null. Zmniejszenie zachowuje wartości o indeksach mniejszych niż $size, a pozostałe usuwa. Ponowne zwiększenie rozmiaru ich nie przywraca. Rozmiar 0 usuwa wszystkie pozycje. Jeśli rozmiar się nie zmienia, zawartość pozostaje bez zmian.
W PHP 8.3 wstępny typ zwracany metody to bool, ale po poprawnym zakończeniu wywołania wynikiem jest true, a nie nowy rozmiar. Aby odczytać rozmiar, użyj $array->getSize(). Od PHP 8.4 wstępny typ zwracany zmieniono na true. Ujemny rozmiar powoduje zgłoszenie ValueError. PHP_INT_MAX to górna granica typu int, a nie gwarancja, że wystarczy pamięci na tyle pozycji.
Przykłady
<?php
declare(strict_types=1);
$array = new SplFixedArray(2);
$array[0] = 10;
$array[1] = 20;
$result = $array->setSize(3);
echo json_encode([$result, $array->getSize(), $array[0], $array[2]]), "\n";
$array->setSize(1);
echo $array->getSize(), "\n";
$array->setSize(2);
echo json_encode([$array->getSize(), $array[0], $array[1]]), "\n";
try {
$array->setSize(-1);
} catch (ValueError $error) {
echo "ValueError\n";
}
Wynik
[true,3,10,null] 1 [2,10,null] ValueError
Pierwszy wiersz pokazuje wynik `true`, rozmiar `3`, zachowaną wartość `10` i nową pozycję z `null`. Po zmniejszeniu do `1` i ponownym zwiększeniu do `2` pod indeksem `1` jest `null`, a nie dawne `20`. Ostatni wiersz pochodzi z obsługi `ValueError`.
Powiązane lekcje
- PHP · Lekcja 66 · Zaawansowany · Wersja: 2