PHP array_push – Acervo Lima Tutorials

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 ) : intLinguagem 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.

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 $numbersarray.

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 )

Use a função PHP array_push()para adicionar um ou mais elementos ao final de um array.

PHP array_unshift