array_unshift

(PHP 4, PHP 5, PHP 7)

array_unshiftEmpile un ou plusieurs éléments au début d'un tableau

Description

array_unshift ( array &$array [, mixed $... ] ) : int

array_unshift() ajoute les éléments value1, ..., passés en argument au début du tableau array. Notez que les éléments sont ajoutés comme un tout, et qu'ils restent dans le même ordre. Toutes les clés numériques seront modifiées afin de commencer à partir de zéro, tandis que les clés littérales ne seront pas touchées.

Liste de paramètres

array

Le tableau d'entrée.

...

Valeur à empiler.

Valeurs de retour

Retourne le nouveau nombre d'éléments du tableau array.

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_unshift()

<?php
$queue 
= array("orange""banana");
array_unshift($queue"apple""raspberry");
print_r($queue);
?>

L'exemple ci-dessus va afficher :

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

Voir aussi

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