Manuel PHP
Précédent |  | Suivant

# 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 1. 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().

Précédent | Sommaire | Suivant
array_product | Niveau supérieur | array_rand