array_push

(PHP 4, PHP 5)

array_push — 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() - Liefert und entfernt das letzte Element eines Arrays
array_shift() - Liefert ein Element vom Beginn eines Arrays
array_unshift() - Fügt ein oder mehr Elemente am Anfang eines Arrays ein