WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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

Quellen