WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / PHP

SplFixedArray::toArray — In ein normales PHP-Array umwandeln

`toArray()` gibt ein normales PHP-Array mit allen Positionen zurück, auch denen mit dem Wert `null`, ohne das ursprüngliche Objekt zu ändern.

Version: PHP 8.3

Syntax

public function toArray(): array

SplFixedArray::toArray ist eine öffentliche Instanzmethode der SPL-Klasse \SplFixedArray. In Standard-Builds von PHP 8.3 ist SPL immer aktiviert. Rufe die Methode mit -> auf einem Objekt auf: $fixed->toArray(). Die Methode nimmt keine Argumente entgegen und gibt ein array zurück, kein SplFixedArray-Objekt.

Das Ergebnis behält die Reihenfolge und die bei 0 beginnenden ganzzahligen Indizes bei. Positionen, denen du keinen Wert zugewiesen hast, sind weiterhin mit null enthalten; die Methode überspringt sie nicht. Bei Größe null gibt sie [] zurück.

Verwende die Methode, wenn Code ein array erwartet oder wenn du mit [] Elemente anhängen möchtest, ohne die Größe des ursprünglichen Objekts zu ändern. Wenn du im Ergebnis einen skalaren Wert ersetzt oder ein Element anhängst, bleibt das Original unverändert. Es ist jedoch keine tiefe Kopie: Enthält ein Element ein Objekt, sind Änderungen an dessen Eigenschaften auch über das Original sichtbar.

Beispiele

<?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";

Ergebnis

[12,null,30]
[99,null,30,40]
[12,null,30]

Die erste Zeile zeigt, dass Index `1` weiterhin `null` enthält. Die zweite zeigt den ersetzten Wert an Index `0` und das angehängte Element. Die dritte zeigt, dass das ursprüngliche Objekt unverändert ist. `json_encode()` dient nur zur Ausgabe des Ergebnisses.

Zugehörige Lektionen

  • PHP · Lektion 66 · Fortgeschritten · Version: 2

Quellen