PHP-Handbuch: Fügt ein oder mehr Elemente an das Ende eines Arrays an

Beschreibung

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

array_push behandelt array als Stapel (Stack), und fügt die übergebenen Variablen an das Ende von array an. Die Länge von array wird dabei um die Anzahl der angefügten Variablen erhöht. Dies hat den selben Effekt wie:


<?php
$array[] = $var;
?>

für jeden übergebenen Wert wiederholt.

Hinweis: Wenn Sie array_push verwenden, um ein Element an ein Array anzuhängen, ist es besser $array[] = zu benutzen, da dies den zusätzlichen Aufwand vermeidet, eine Funktion aufzurufen

Hinweis: array_push gibt eine Warnung aus, wenn das erste Argument kein Array ist. Dies unterscheidet sich vom Verhalten von $var[], welches ein neues Array erzeugt.

Parameter-Liste

array: Das Eingabe-Array.
value1: Der erste Wert, der an das Ende von array angefügt werden soll.

Rückgabewerte

Liefert die neue Anzahl Elemente des Arrays.

Beispiele

Beispiel #1 array_push Beispiel


<?php
$stack = array("Orange", "Banane");
array_push($stack, "Apfel", "Himbeere");
print_r($stack);
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Array
(
    [0] => Orange
    [1] => Banane
    [2] => Apfel
    [3] => Himbeere
)

Siehe auch

array_pop
array_shift
array_unshift