array_push

(PHP 4, PHP 5)

array_push — Fügt ein oder mehr Elemente an das Ende eines Arrays

Beschreibung

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

array_push() behandelt array als Stapel (Stack), und fügt die übergebenen Variablen an das Ende von array . 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 jede Variable var wiederholt.

Liefert die neue Anzahl Elemente des Arrays.

Beispiel #1 array_push()


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

Danach enthält $stack die folgenden Elemente:

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

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 Warung aus, wenn das erste Argument kein Array ist. Dies unterscheidet sich vom Verhalten von $var[], welches ein neues Array erzeugt.

Siehe auch array_pop(), array_shift() und array_unshift().