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

# array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Beschreibung

function array_push(array `&$array`, mixed `...$values`): int

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 unterschied sich vom Verhalten von `$var[]` vor PHP 7.1.0, bei dem ein neues Array erstellt wurde.

### Parameter-Liste

`array`

  Das Eingabe-Array.

`values`

  Die Werte, die am Ende von `array` angefügt werden sollen.

### Rückgabewerte

Liefert die neue Anzahl Elemente des Arrays.

### Changelog

Version | Beschreibung
--- | ---
7.3.0 | Diese Funktion kann nun mit nur einem Parameter aufgerufen werden. Zuvor waren mindestens zwei Parameter erforderlich.

### 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 und entfernt das erste Element eines Arrays
- array_unshift() - Fügt ein oder mehr Elemente am Anfang eines Arrays ein

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open