Empile un ou plusieurs éléments à la fin d'un tableau

# array_push

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

array_push — Empile un ou plusieurs éléments à la fin d'un tableau

### Description

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

array_push() considère `array` comme une pile, et empile les variables `values` à la fin de `array`. La longueur du tableau `array` augmente d'autant. Cela a le même effet que :

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

répété pour chaque valeur.

> Note: Si l'on utilise la fonction array_push() pour ajouter un élément à un tableau, il est préférable de la remplacer par l'opérateur `$array[] =` qui évite le passage par une fonction.

> Note: array_push() émettra une alerte si le premier argument n'est pas un tableau. Ceci diffère du comportement de `$var[]` où un nouveau tableau était créé, avant PHP 7.1.0.

### Liste de paramètres

`array`

  Le tableau d'entrée.

`values`

  Les valeurs à insérer à la fin du tableau `array`.

### Valeurs de retour

Retourne le nouveau nombre d'éléments dans le tableau.

### Historique

Version | Description
--- | ---
7.3.0 | Cette fonction peut désormais être appelée avec un seul paramètre. Auparavant, au moins deux paramètres étaient requis.

### Exemples

Exemple #1 Exemple avec array_push()

    <?php
    $stack = array("orange", "banana");
    array_push($stack, "apple", "raspberry");
    print_r($stack);
    ?>

L'exemple ci-dessus va afficher :

    Array
    (
        [0] => orange
        [1] => banana
        [2] => apple
        [3] => raspberry
    )

### Voir aussi

- array_pop() - Dépile un élément de la fin d'un tableau
- array_shift() - Dépile un élément au début d'un tableau
- array_unshift() - Empile un ou plusieurs éléments au début d'un tableau

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