(PHP 4, PHP 5, PHP 7, PHP 8)
array_unshift — Empile un ou plusieurs éléments au début d'un tableau
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.
Note:
Réinitialise le pointeur interne du tableau au premier élément.
array
Le tableau d'entrée.
values
Valeur à empiler.
Retourne le nouveau nombre d'éléments du tableau
array
.
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. |
Exemple #1 Exemple avec array_unshift()
<?php
$queue = [
"orange",
"banana"
];
array_unshift($queue, "apple", "raspberry");
var_dump($queue);
?>
L'exemple ci-dessus va afficher :
array(4) { [0] => string(5) "apple" [1] => string(9) "raspberry" [2] => string(6) "orange" [3] => string(6) "banana" }
Exemple #2 Utilisation avec des tableaux associatifs
Si un tableau associatif est ajouté en préfixe à un autre tableau associatif, le tableau ajouté est indexé numériquement dans le tableau précédent
<?php
$foods = [
'apples' => [
'McIntosh' => 'red',
'Granny Smith' => 'green',
],
'oranges' => [
'Navel' => 'orange',
'Valencia' => 'orange',
],
];
$vegetables = [
'lettuce' => [
'Iceberg' => 'green',
'Butterhead' => 'green',
],
'carrots' => [
'Deep Purple Hybrid' => 'purple',
'Imperator' => 'orange',
],
'cucumber' => [
'Kirby' => 'green',
'Gherkin' => 'green',
],
];
array_unshift($foods, $vegetables);
var_dump($foods);
L'exemple ci-dessus va afficher :
array(3) { [0]=> array(3) { ["lettuce"]=> array(2) { ["Iceberg"]=> string(5) "green" ["Butterhead"]=> string(5) "green" } ["carrots"]=> array(2) { ["Deep Purple Hybrid"]=> string(6) "purple" ["Imperator"]=> string(6) "orange" } ["cucumber"]=> array(2) { ["Kirby"]=> string(5) "green" ["Gherkin"]=> string(5) "green" } } ["apples"]=> array(2) { ["McIntosh"]=> string(3) "red" ["Granny Smith"]=> string(5) "green" } ["oranges"]=> array(2) { ["Navel"]=> string(6) "orange" ["Valencia"]=> string(6) "orange" } }