(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 a função array_push() for usada para adicionar um elemento ao array, é melhor usar
$array[] =porque desta forma 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.
arrayO 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. 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
)