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