ZAČÁTKYNÁVODYOOPDOKUMENTACE
Dokumentace/
Pole

PHP funkce array_unshift()

11. 09. 2019

Obsah článku

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

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:

Související články

1.
5.

Potřebujete poradit s PHP?

Nabízím trénink vývojářů, konzultace, školení a analýzu návrhových vzorů. Osobně v Praze nebo online.

Napište mi, pokud si nevíte rady.

Lektor: Jan Barášek

V jiných jazycích