Forum und email

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.

Example#1 Exemplo de array_push()

<?php
$cesta 
= array("laranja""morango");
array_push($cesta"melancia""batata");
print_r($cesta);
?>

O exemplo acima irá imprimir:

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().