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 tamanho do 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.

Note: 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.

Note: 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.

Parâmetros

array

O array de entrada.

var

O valor a ser adicionado.

Valor Retornado

Retorna o novo número de elementos do array.

Exemplos

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
)

Veja Também