CKTIS / PHP
SplFixedArray::offsetSet — Écrire une valeur à un indice
Écrivez ou remplacez une valeur dans un tableau de taille fixe. Comparez l’appel direct à l’affectation par crochets et distinguez les erreurs d’indice en PHP 8.3.
Version : PHP 8.3
Syntaxe
$array->offsetSet($index, $value);
$array[$index] = $value;SplFixedArray::offsetSet écrit dans une case existante d’un objet \SplFixedArray, une classe de SPL dans l’espace de noms global. SPL fait partie du cœur de PHP et est toujours activée dans les compilations standard de PHP 8.3. Avec un indice entier valide, $array->offsetSet($index, $value) et $array[$index] = $value écrivent dans la même case. La valeur peut être de n’importe quel type (mixed), y compris null. La méthode modifie l’objet et ne renvoie rien (void).
Un indice valide vérifie 0 <= $index && $index < $array->getSize(). Pour une taille de 2, on peut écrire aux indices 0 et 1, mais pas à l’indice 2. L’écriture ne change pas la taille, et $array[] = $value n’ajoute pas d’élément comme dans un tableau PHP ordinaire. Pour ajouter des cases, appelez d’abord setSize(), puis écrivez à un indice explicite.
En PHP 8.3, un indice entier hors limites déclenche RuntimeException, tandis qu’une clé non valide comme 'label' déclenche TypeError. À partir de PHP 8.4, la classe d’exception précise pour un indice hors limites est OutOfBoundsException, une sous-classe de RuntimeException. Si l’indice provient d’une entrée externe, vérifiez is_int($index) et les limites plutôt que de compter sur une conversion implicite.
Exemples
<?php
$array = new \SplFixedArray(2);
$array->offsetSet(1, 'draft');
echo $array[1], "\n";
$array[1] = 'ready';
echo $array[1], "\n";
try {
$array->offsetSet(2, 'extra');
} catch (\RuntimeException $error) {
echo get_class($error), "\n";
}
try {
$array['label'] = 'extra';
} catch (\TypeError $error) {
echo get_class($error), "\n";
}
Résultat
draft ready RuntimeException TypeError
Le script utilise la méthode pour stocker `draft` à l’indice 1, puis remplace cette valeur par `ready` au moyen d’une affectation par crochets. Il affiche ensuite les noms des classes d’exception pour l’indice 2 et la clé `'label'`, respectivement.
Leçons associées
- PHP · Leçon 66 · Avancé · Version : 2