CKTIS / PHP
SplFixedArray::toArray — Convertir en tableau PHP natif
`toArray()` renvoie un tableau PHP natif contenant toutes les positions, y compris celles qui valent `null`, sans modifier l’objet d’origine.
Version : PHP 8.3
Syntaxe
public function toArray(): arraySplFixedArray::toArray est une méthode d’instance publique de la classe SPL \SplFixedArray. SPL est toujours activée dans les compilations standard de PHP 8.3. Appelez cette méthode sur un objet avec -> : $fixed->toArray(). Elle ne prend aucun argument et renvoie un array, pas un objet SplFixedArray.
Le résultat conserve l’ordre et les indices entiers à partir de 0. Les positions auxquelles aucune valeur n’a été affectée restent présentes avec la valeur null ; la méthode ne les ignore pas. Si la taille du tableau fixe est nulle, elle renvoie [].
Utilisez cette méthode quand le code attend un array ou pour ajouter des éléments avec [] sans redimensionner l’objet d’origine. Remplacer une valeur scalaire ou ajouter un élément dans le résultat ne modifie pas la source. Il ne s’agit toutefois pas d’une copie profonde : si un élément contient un objet, la modification de ses propriétés via le résultat est aussi visible via la source.
Exemples
<?php
$fixed = new \SplFixedArray(3);
$fixed[0] = 12;
$fixed[2] = 30;
$values = $fixed->toArray();
echo json_encode($values), "\n";
$values[0] = 99;
$values[] = 40;
echo json_encode($values), "\n";
echo json_encode($fixed->toArray()), "\n";
Résultat
[12,null,30] [99,null,30,40] [12,null,30]
La première ligne montre que l’indice `1` vaut toujours `null`. La deuxième montre la valeur remplacée à l’indice `0` et l’élément ajouté. La troisième montre que l’objet d’origine n’a pas changé. `json_encode()` sert uniquement à afficher le résultat.
Leçons associées
- PHP · Leçon 66 · Avancé · Version : 2