CKTIS / PHP
SplFixedArray
Réserve un nombre de positions indexées à partir de zéro.
Version : PHP 8.4; repository runtime, production runtime not attested
Syntaxe
new SplFixedArray($size)Réserve un nombre de positions indexées à partir de zéro. Les cases non affectées contiennent null et count mesure la capacité courante. setSize la modifie et une réduction supprime les dernières cases. En PHP 8.4 un indice hors limites lève OutOfBoundsException. La méthode SplFixedArray::offsetSet écrit dans une position allouée et SplFixedArray::offsetGet en lit la valeur. La méthode SplFixedArray::count compte toutes les positions, même null, SplFixedArray::toArray renvoie leurs valeurs dans un tableau ordinaire et SplFixedArray::setSize change la taille.
$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
Exemples
<?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);}
Résultat
[[null,"B","C"],2,[null,"B"]] [null,"B"] OutOfBoundsException