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

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

Sources