array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.array-push.php', 1 => 'array_push', ), 'up' => array ( 0 => 'ref.array.php', 1 => 'Funções para Array', ), 'prev' => array ( 0 => 'function.array-product.php', 1 => 'array_product', ), 'next' => array ( 0 => 'function.array-rand.php', 1 => 'array_rand', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/array/functions/array-push.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Adiciona um ou mais elementos no final de um array
array_push() trata array
como uma
pilha, e adiciona as variáveis passadas como argumentos no final de
array
. O tamanho do array
aumenta de acordo com o número de variáveis adicionadas. Tem o mesmo efeito de:
<?php
$array[] = $var;
?>
Nota: Se você usar array_push() para adicionar um elemento ao array, é melhor usar
$array[] =
porque deste jeito não há uma chamada a uma função.
Nota: array_push() irá emitir um aviso se o primeiro argumento não for um array. Isto era diferente do funcionamento de
$var[]
onde um novo array era criado, antes do PHP 7.1.0.
array
O array de entrada.
values
Os valores a serem colocados no final do array
.
Retorna o novo número de elementos do array.
Versão | Descrição |
---|---|
7.3.0 | Essa função agora pode ser chamada com apenas um parâmetro. This function can now be called with only one parameter. Anteriormente, pelo menos dois parâmetros eram necessários. |
Exemplo #1 Exemplo de array_push()
<?php
$cesta = array("laranja", "morango");
array_push($cesta, "melancia", "batata");
print_r($cesta);
?>
O exemplo acima produzirá:
Array ( [0] => laranja [1] => morango [2] => melancia [3] => batata )