Adiciona um ou mais elementos no final de um array

# array_push

(PHP 4, PHP 5, PHP 7, PHP 8)

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

### Descrição

function array_push(array `&$array`, mixed `...$values`): int

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.

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

> Nota: 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

Exemplo #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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open