Resumo : neste tutorial, você aprenderá como adicionar um elemento ao final de um array usando a array_push()
função PHP.
Introdução à função array_push() do PHP
A array_push()
função adiciona um ou mais elementos ao final de um array. A sintaxe da array_push()
função é a seguinte:
array_push ( array &$array , mixed ...$values ) : int
Linguagem de código: PHP ( php )
Nesta sintaxe:
$array
é a matriz de entrada.$values
é um ou mais elementos a serem colocados no final da matriz de entrada.
A array_push()
função retorna o novo número de elementos do array.
Observe que a função array_push() modifica o array de entrada.
O array_push()
tem o mesmo efeito que a seguinte instrução repetida para cada novo valor:
$array[] = $value;
Linguagem de código: PHP ( php )
Se você apenas adicionar um valor a um array, deverá usar a instrução $array[] = $value;
para evitar a sobrecarga de chamar a array_push()
função.
Exemplos de funções PHP array_push()
O exemplo a seguir mostra como usar a array_push()
função para adicionar vários elementos ao final de um array:
<?php
$numbers = [1, 2, 3];
array_push($numbers, 4, 5);
print_r($numbers);
Linguagem de código: HTML, XML ( xml )
Saída:
Array
(
[0] => 1
[1] => 2
[2] => 3
[3] => 4
[4] => 5
)
Linguagem de código: PHP ( php )
Neste exemplo, colocamos os números 4 e 5 no final do $numbers
array.
Empurre um elemento para o final de uma matriz associativa
Para adicionar um elemento a um array associativo, use a seguinte sintaxe:
$array[$key] = $value;
Linguagem de código: PHP ( php )
Neste caso, você não pode usar a array_push()
função. Por exemplo:
<?php
$roles = [
'admin' => 1,
'editor' => 2
];
$roles['approver'] = 3;
print_r($roles);
Linguagem de código: HTML, XML ( xml )
Saída:
Array
(
[admin] => 1
[editor] => 2
[approver] => 3
)
Linguagem de código: PHP ( php )
Resumo
- Use a função PHP
array_push()
para adicionar um ou mais elementos ao final de um array.