Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / PHP

SplFixedArray

Rezerwuje określoną liczbę pozycji od indeksu zero.

Wersja: PHP 8.4; repository runtime, production runtime not attested

Składnia

new SplFixedArray($size)

Rezerwuje określoną liczbę pozycji od indeksu zero. Nieprzypisane pola mają null, a count mierzy bieżącą pojemność. setSize zmienia pojemność i przy zmniejszeniu odrzuca końcowe pola. Indeks poza zakresem w PHP 8.4 powoduje OutOfBoundsException. Metoda SplFixedArray::offsetSet zapisuje wartość w przydzielonej pozycji, a SplFixedArray::offsetGet ją odczytuje. Metoda SplFixedArray::count liczy wszystkie pozycje, także z null, SplFixedArray::toArray zwraca zwykłą tablicę z ich wartościami, a SplFixedArray::setSize zmienia rozmiar.

$a=new SplFixedArray(3); $a->offsetSet(1,"B"); $a->offsetSet(2,"C"); $initial=$a->toArray();
$a->setSize(2); echo json_encode([$initial,$a->count(),$a->toArray()]);
echo PHP_EOL,json_encode([$a->offsetGet(0),$a->offsetGet(1)]);
try{$x=$a->offsetGet(2);}catch(OutOfBoundsException $e){echo PHP_EOL,get_class($e);}
[[null,"B","C"],2,[null,"B"]]
[null,"B"]
OutOfBoundsException

Przykłady

<?php
$a=new SplFixedArray(3); $a->offsetSet(1,"B"); $a->offsetSet(2,"C"); $initial=$a->toArray();
$a->setSize(2); echo json_encode([$initial,$a->count(),$a->toArray()]);
echo PHP_EOL,json_encode([$a->offsetGet(0),$a->offsetGet(1)]);
try{$x=$a->offsetGet(2);}catch(OutOfBoundsException $e){echo PHP_EOL,get_class($e);}

Wynik

[[null,"B","C"],2,[null,"B"]]
[null,"B"]
OutOfBoundsException

Źródła