array_push

(PHP 4, PHP 5)

array_push — Wstaw jeden lub więcej elementów na koniec tablicy

Opis

int array_push ( array &$tablica , mixed $wartosc [, mixed $... ] )

array_push() traktuje zmienną tablica jako stos i wstawia przekazane parametry na koniec podanej tablicy. Długość parametru tablica zwiększa się o liczbę przekazanych wartości. Ma to taki sam efekt jak kod:


<?php
$tablica[] = $wartosc;
?>

powtórzony dla każdego parametru wartosc.

Funkcja zwraca nową liczbę elementów tablicy.

Przykład #1 Przykład użycia array_push()


<?php
$stos = array("pomarańcza", "banan");
array_push($stos, "jabłko", "malina");
print_r($stos);
?>

Powyższy przykład wyświetli:

Array
(
    [0] => pomarańcza
    [1] => banan
    [2] => jabłko
    [3] => malina
)

Informacja: Jeśli funkcja array_push() ma być użyta do dodania tylko jednego elementu do tablicy, lepiej jest użyć składni $tablica[] = , ponieważ nie powoduje to narzutu przez konieczność wywołanie funkcji.

Informacja: array_push() wygeneruje ostrzeżenie, jeśli pierwszy argument nie jest tablicą. Różni się to od zachowania dla $var[], kiedy to tworzona jest nowa tablica.

Patrz także: array_pop(), array_shift() i array_unshift().