Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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

Źródła