array_push

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

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

Description

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: La valeur à 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.

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