array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-unshift.php', 1 => 'array_unshift', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-unique.php', 1 => 'array_unique', ), 'next' => array ( 0 => 'function.array-values.php', 1 => 'array_values', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-unshift.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_unshift — Adiciona um ou mais elementos no início de um array
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.
Nota:
Redefine o ponteiro interno do array para o primeiro elemento.
array
O array de entrada.
values
Os valores a serem adicionados.
Retorna o novo número de elementos em array
.
Versão | Descrição |
---|---|
7.3.0 | Essa função agora pode ser chamada com apenas um parâmetro. Anteriomente, pelo menos dois parâmetros eram necessários. |
Exemplo #1 Exemplo de array_unshift()
<?php
$cesta = [
"laranja",
"banana"
];
array_unshift($cesta, "melancia", "morango");
var_dump($cesta);
?>
O exemplo acima produzirá:
array(4) { [0] => string(8) "melancia" [1] => string(7) "morango" [2] => string(7) "laranja" [3] => string(6) "banana" }
Exemplo #2 Uso de arrays associativos
Se um array associativo é pre anexado a outro array associativo, o array anexado é numeralmente indexado no array anterior.
<?php
$frutas = [
'maca' => [
'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);
O exemplo acima produzirá:
array(3) { [0] => 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" } }