PHP funkce array_unshift()
Funkce připojí jeden nebo více prvků na začátek pole.
Pozor: Číselné indexy budou přečíslovány od nuly. Funkce resetuje vnitřní ukazatel na aktuální prvek v poli.
Použití
array_unshift(array array, mixed var [, mixed ...])
Funkce vezme předaný prvek, který umístí na začátek nového pole. Za předaný prvek poté překopíruje původní pole se zachováním klíčů a pořadí.
Funkce vrátí nový počet prvků v poli. Pole se však upravuje přes referenci, takže je potřeba přečíst z proměnné, v které bylo předáno.
Použití je například:
$queue = ['p1', 'p3'];
array_unshift($queue, 'p4', 'p5', 'p6');
Upravené pole $queue
bude mít 5 prvků: "p4", "p5", "p6", "p1" a "p3".
Parametry
Parametr | Datový typ | Výchozí hodnota | Poznámka |
---|---|---|---|
$array | array | není | Upravované pole. |
$var | mixed | není | Hodnota, která půjde na začátek pole. |
$_ | mixed | null | Volitelně další hodnoty, které půjdou na začátek pole. |
Návratové hodnoty
Vrátí int
vyjadřující nový počet prvků v poli.
Další zdroje
[Oficiální dokumentace funkce array-unshift](Oficiální dokumentace)
Jan Barášek Více o autorovi
Autor článku pracuje jako seniorní vývojář a software architekt v Praze. Navrhuje a spravuje velké webové aplikace, které znáte a používáte. Od roku 2009 nabral bohaté zkušenosti, které tímto webem předává dál.
Rád vám pomůžu:
Kontakt Spolupráce