array_unshift
Adiciona um ou mais elementos no início de um array
&reftitle.description;
intarray_unshift
arrayarray
mixedvalues
array_unshift adiciona os elementos passados como
argumentos no início de array. Note que a lista
de elementos é adicionada como um todo, de forma que eles ficam na
mesma ordem. Todas as chaves numéricas serão modificadas para começar a
contar de zero enquanto chaves literais permanecerão inalteradas.
¬e.reset-index;
&reftitle.parameters;
array
O array de entrada.
values
Os valores a serem adicionados.
&reftitle.returnvalues;
Retorna o novo número de elementos em array.
&reftitle.changelog;
&Version;
&Description;
7.3.0
Essa função agora pode ser chamada com apenas um parâmetro. Anteriomente, pelo
menos dois parâmetros eram necessários.
&reftitle.examples;
Exemplo de <function>array_unshift</function>
]]>
&example.outputs;
string(8) "melancia"
[1] =>
string(7) "morango"
[2] =>
string(7) "laranja"
[3] =>
string(6) "banana"
}
]]>
Uso de arrays associativos
Se um array associativo é pre anexado a outro array associativo,
o array anexado é numeralmente indexado no array anterior.
[
'McIntosh' => 'vermelho',
'Granny Smith' => 'verde',
],
'laranja' => [
'Navel' => 'laranja',
'Valencia' => 'laranja',
],
];
$vegetais = [
'alface' => [
'Iceberg' => 'verde',
'Butterhead' => 'verde',
],
'cenoura' => [
'Deep Purple Hybrid' => 'roxo',
'Imperator' => 'laranja',
],
'pepino' => [
'Kirby' => 'verde',
'Gherkin' => 'verde',
],
];
array_unshift($frutas, $vegetais);
var_dump($frutas);
?>
]]>
&example.outputs;
array(3) {
["alface"]=>
array(2) {
["Iceberg"]=>
string(5) "verde"
["Butterhead"]=>
string(5) "verde"
}
["cenoura"]=>
array(2) {
["Deep Purple Hybrid"]=>
string(4) "roxo"
["Imperator"]=>
string(7) "laranja"
}
["pepino"]=>
array(2) {
["Kirby"]=>
string(5) "verde"
["Gherkin"]=>
string(5) "verde"
}
}
["maca"]=>
array(2) {
["McIntosh"]=>
string(8) "vermelho"
["Granny Smith"]=>
string(5) "verde"
}
["laranja"]=>
array(2) {
["Navel"]=>
string(7) "laranja"
["Valencia"]=>
string(7) "laranja"
}
}
]]>
&reftitle.seealso;
array_merge
array_shift
array_push
array_pop