CKTIS / PHP
Redimensionner un SplFixedArray avec SplFixedArray::setSize
Modifie la taille d’un `SplFixedArray` existant. L’agrandir ajoute des cases initialisées à `null` ; le réduire supprime les valeurs en fin de tableau.
Version : PHP 8.3
Syntaxe
PHP 8.3: $array->setSize(int $size) → bool (tentative return type; returns true on normal completion). $array is a SplFixedArray instance.SplFixedArray::setSize modifie la taille d’un objet SPL existant sans en créer un nouveau. C’est une méthode d’instance : appelle-la avec $array->setSize($size). L’argument $size, de type int, indique le nombre de cases voulu, pas le nombre à ajouter ni le dernier indice. Pour une taille positive, les indices vont de 0 à $size - 1.
L’agrandissement conserve les valeurs existantes et initialise les nouvelles cases à null. La réduction conserve les valeurs aux indices inférieurs à $size et supprime les autres. Un nouvel agrandissement ne les restaure pas. La taille 0 supprime toutes les cases. Si la taille ne change pas, le contenu reste inchangé.
Dans PHP 8.3, le type de retour provisoire est bool, mais la méthode renvoie true quand elle se termine normalement, et non la nouvelle taille. Pour lire la taille, utilise $array->getSize(). Depuis PHP 8.4, le type de retour provisoire est true. Une taille négative déclenche une ValueError. PHP_INT_MAX est la borne supérieure du type int et ne garantit pas qu’il y ait assez de mémoire pour autant de cases.
Exemples
<?php
declare(strict_types=1);
$array = new SplFixedArray(2);
$array[0] = 10;
$array[1] = 20;
$result = $array->setSize(3);
echo json_encode([$result, $array->getSize(), $array[0], $array[2]]), "\n";
$array->setSize(1);
echo $array->getSize(), "\n";
$array->setSize(2);
echo json_encode([$array->getSize(), $array[0], $array[1]]), "\n";
try {
$array->setSize(-1);
} catch (ValueError $error) {
echo "ValueError\n";
}
Résultat
[true,3,10,null] 1 [2,10,null] ValueError
La première ligne affiche le retour `true`, la taille `3`, la valeur `10` conservée et une nouvelle case à `null`. Après une réduction à `1` et un agrandissement à `2`, l’indice `1` contient `null`, pas l’ancienne valeur `20`. La dernière ligne est affichée lorsqu’on intercepte `ValueError`.
Leçons associées
- PHP · Leçon 66 · Avancé · Version : 2