Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / PHP

SplFixedArray::toArray — Převod na běžné pole PHP

`toArray()` vrací běžné pole PHP se všemi pozicemi včetně těch, které obsahují hodnotu `null`, a původní objekt přitom nemění.

Verze: PHP 8.3

Syntaxe

public function toArray(): array

SplFixedArray::toArray je veřejná instanční metoda třídy \SplFixedArray z knihovny SPL. Ve standardních sestaveních PHP 8.3 je knihovna SPL vždy povolena. Metodu volejte na objektu pomocí ->: $fixed->toArray(). Nepřijímá žádné argumenty a vrací hodnotu typu array, nikoli objekt SplFixedArray.

Výsledek zachovává pořadí i celočíselné indexy od 0. Pozice, kterým jste nepřiřadili hodnotu, zůstávají ve výsledku s hodnotou null; metoda je nepřeskakuje. Má-li pole s pevnou velikostí velikost nula, metoda vrátí [].

Metodu použijte, když kód očekává array nebo když chcete přidávat prvky pomocí [] beze změny velikosti původního objektu. Nahrazení skalární hodnoty nebo přidání prvku ve výsledku zdroj nezmění. Nejde však o hlubokou kopii: obsahuje-li prvek objekt, změny jeho vlastností provedené přes výsledek jsou viditelné i přes zdroj.

Příklady

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

Výsledek

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

První řádek ukazuje, že na indexu `1` je stále `null`. Druhý ukazuje nahrazenou hodnotu na indexu `0` a přidaný prvek. Třetí ukazuje, že původní objekt se nezměnil. `json_encode()` slouží pouze k zobrazení výsledku.

Související lekce

  • PHP · Lekce 66 · Pokročilá · Verze: 2

Zdroje