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 vous utilisez 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éé, antérieurement à 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

    VersionDescription
    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

    To Top