Manual do PHP
Anterior |  | Próxima

# array_push

(PHP 4, PHP 5)

array_push -- Adiciona um ou mais elementos no final de um array

## Descrição

int array_push ( array &array, mixed var [, mixed ...] )

array_push() trata `array` como uma pilha, e adiciona as variáveis passadas como argumentos no final de `array`. O comprimento de `array` aumenta de acordo com o número de variáveis adicionadas. Tem o mesmo efeito de:

`<?php $array[] = $var; ?>`

repetido para cada argumento `var`.

Retorna o novo número de elementos do array.

Exemplo 1. Exemplo de array_push()
`<?php $cesta = array("laranja", "morango"); array_push($cesta, "melancia", "batata"); print_r($cesta); ?>`
Neste caso `$stack` teria os seguintes elementos:
`Array ( [0] => laranja [1] => morango [2] => melancia [3] => batata )`

> Nota: Se você usar array_push() para adicionar um elemento na 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 é diferente do funcionamento de `$var[]` aonde uma nova matriz é criada.

Veja também: array_pop(), array_shift(), e array_unshift().

Anterior | Principal | Próxima
array_product | Acima | array_rand