array_push

(PHP 4, PHP 5)

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

Description

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

array_push() considère array comme une pile, et empile les variables var , ... à 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 var .

array_push() retourne le nouveau nombre d'éléments du tableau.

Exemple 414. Exemple avec array_push()

<?php
$stack 
= array ( "orange" "banane" );
array_push  ( $stack "pomme" "bleuet" );
print_r ( $stack );
?>

L'exemple ci-dessus va afficher :

Array
(
    [0] => orange
    [1] => banane
    [2] => pomme
    [3] => bleuet
)

Note: Si vous utilisez la fonction array_push() pour ajouter un élément à un tableau, il est mieux 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 est créé.

Voir aussi array_pop() , array_shift() et array_unshift() .