array_push
(PHP 4, PHP 5, PHP 7, PHP 8)
array_push — Adiciona um ou mais elementos no final de um array
Descrição
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;
?>Note: 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.
Note: 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.
Parâmetros
array-
O array de entrada.
values-
Os valores a serem colocados no final do
array.
Valor Retornado
Retorna o novo número de elementos do array.
Registro de Alterações
| 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. |
Exemplos
Example #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
)
Veja Também
- array_pop() - Extrai um elemento do final do array
- array_shift() - Retira o primeiro elemento de um array
- array_unshift() - Adiciona um ou mais elementos no início de um array