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

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(): array

SplFixedArray::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

Sources