Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources