array_unshift
Empile un ou plusieurs éléments au début d'un tableau
&reftitle.description;
intarray_unshift
arrayarray
mixedvalues
array_unshift ajoute les éléments value1,
..., passés
en argument au début du tableau array. Il est à noter 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.
¬e.reset-index;
&reftitle.parameters;
array
Le tableau d'entrée.
values
Valeur à empiler.
&reftitle.returnvalues;
Retourne le nouveau nombre d'éléments du tableau
array.
&reftitle.changelog;
&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.
&reftitle.examples;
Exemple avec <function>array_unshift</function>
]]>
&example.outputs;
string(5) "apple"
[1] =>
string(9) "raspberry"
[2] =>
string(6) "orange"
[3] =>
string(6) "banana"
}
]]>
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
[
'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);
]]>
&example.outputs;
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"
}
}
]]>
&reftitle.seealso;
array_merge
array_shift
array_push
array_pop