PHP funkce array_unshift()

Dostupnost ve verzích: `PHP 4.0`

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

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:

KontaktSpolupráce