CKTIS / PHP
SplFixedArray
Reserviert eine feste Zahl von Plätzen ab Index null.
Version: PHP 8.4; repository runtime, production runtime not attested
Syntax
new SplFixedArray($size)Reserviert eine feste Zahl von Plätzen ab Index null. Unbelegte Plätze enthalten null und count misst die aktuelle Kapazität. setSize ändert sie und verwirft beim Verkleinern entfernte Plätze. Ein ungültiger Index löst in PHP 8.4 OutOfBoundsException aus. Die Methode SplFixedArray::offsetSet schreibt in eine zugeteilte Position und SplFixedArray::offsetGet liest sie. Dabei zählt SplFixedArray::count auch Plätze mit null, SplFixedArray::toArray liefert ein normales Array mit den Werten und SplFixedArray::setSize ändert die Größe.
$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
Beispiele
<?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);}
Ergebnis
[[null,"B","C"],2,[null,"B"]] [null,"B"] OutOfBoundsException