Função array_push() PHP

Funções de Array PHP

Exemplo

Inserir "blue" e "yellow" no final do array:

<?php
$a=array("red","green");
array_push($a,"blue","yellow");
print_r($a);
?>

Executar Exemplo

Definição e Uso

A função array_push() adiciona um ou mais elementos ao final do array especificado pelo primeiro parâmetro (empilhamento) e retorna o comprimento do novo array.

Esta função é equivalente a várias chamadas $array[] = $value.

Dicas e Comentários

Comentário:Mesmo que o array contenha chaves de string, os elementos adicionados sempre serão de chave numérica. (Veja exemplo 2)

Comentário:Se você deseja adicionar um único elemento a um array com chaves de string, é melhor usar $array[] =, pois isso não carrega o adicional da chamada de função.

Comentário:Se o primeiro parâmetro não for um array, array_push() emitirá um aviso. Isso é diferente do comportamento de $var[], que cria um novo array.

Sintaxe

array_push(array,value1,value2...)
Parâmetros Descrição
array Obrigatório. Especifica o array.
value1 Obrigatório. Especifica o valor a ser adicionado.
value2 Opcional. Especifica o valor a ser adicionado.

Detalhes Técnicos

Retorno: Retorna o número de elementos do novo array.
Versão PHP: 4+

Mais Exemplos

Exemplo 1

Array com chaves de string:

<?php
$a=array("a"=>"red","b"=>"green");
array_push($a,"blue","yellow");
print_r($a);
?>

Executar Exemplo

Funções de Array PHP