array_push

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

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

    Descrição

    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 você usar array_push() para adicionar um elemento ao 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 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ãoDescrição
    7.3.0 Essa função agora pode ser chamada com apenas um parâmetro. This function can now be called with only one parameter. 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

    To Top