(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.
arrayLe tableau d'entrée.
valuesValeur à 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"
}
}