PHP array push: adicionando elementos ao final de arrays!

Em linguagens de programação backend como PHP, no desenvolvimento de sua aplicação, é quase certo que você utilizará funções para manipular dados de estruturas de dados, sejam elas filas, pilhas, listas ou arrays. Portanto, é importante saber ao menos as principais funções de manipulação, para que o desenvolvimento seja mais rápido e produtivo. Uma dessas funções é a PHP array push. 

Ela pode possuir uma escrita de difícil compreensão para pessoas que estejam iniciando na programação, já que elas podem não conhecer o que são arrays e como se manipulam eles. 

Mas, com o aprendizado dessa função, um leque muito grande de coisas poderá se abrir a partir do que fazer com arrays em seus estudos. Vamos explorar essa função mais a fundo? Venha com a gente!

O que é PHP array push?

A função php array push adiciona elementos ao final de um array. Os elementos sempre serão adicionados ao final do array e nunca no começo dele. Nesse caso, é importante dizer que, na linguagem PHP, o array tem início na posição 0 e não na posição 1. 

Ou seja, se o array que você está utilizando tem três elementos e você quer adicionar mais um nele, você utilizará a função push no PHP, para adicionar o elemento desejado ao final do array. Assim, o elemento adicionado ficará ao final do array. 

Vamos imaginar uma situação cotidiana de uma fila em uma lotérica. Imagine que tal fila seja um array de pessoas e você entra nela. Onde você entra? Atrás da última pessoa da fila. É exatamente isso que a função push faz: adiciona um elemento ao final do array, no nosso exemplo, uma pessoa ao final da fila da lotérica.

Legal! Entendi. Mas, como funciona a escrita da função php array push? Esse será o assunto da próxima seção. 

Qual a sintaxe?

A sintaxe, que seria como é escrita essa função, será da seguinte forma:

array_push (array, “os valores que você quer inserir”);

Essa função possui dois parâmetros, que seriam:
– Array → seria o array que você declarou inicialmente e, na função php array push, um dos parâmetros é a chamada ao array declarado.

Valores que você quer inserir → no exemplo da lotérica, imaginemos que as pessoas presentes na fila tenham nomes de João e Kennedy. Aí, entrarão mais pessoas, fictícias, que seriam Fernanda e Joana. 

Nesse caso, a Fernanda e a Joana seriam os valores que desejo inserir no array de pessoas da fila da lotérica.

Não há limite de inserção de valores em um array. Você poderá inserir quantos valores você quiser. No exemplo foram mostrados apenas dois, mas você pode inserir três, quatro, e assim por diante. 

O que foi explicado acima será resumido em uma tabela que será exibida no próximo tópico. 

Quais os parâmetros e valores da função PHP array push?

Conforme visto anteriormente, o parâmetro obrigatório da função seria o array recém declarado por você e os valores seriam os que você deseja inserir no array. 

Na tabela abaixo, serão exibidos os parâmetros e valores no PHP, como eles funcionam:

ParâmetroDescrição
ARRAYEle é o parâmetro obrigatório na função php array push e é o primeiro dela.
No caso, ele seria o vetor de pessoas na lotérica, conforme o exemplo que estamos seguindo.
VALORESOs valores que serão adicionados na fila seriam o de Fernanda e Joana, conforme explicado anteriormente. A quantidade de valores é opcional e pode variar. Mas, para essa adição ser bem sucedida, você precisará passar ao menos um valor para ser adicionado pela função.  


Não se preocupe, pois mostraremos exemplos com código nesse artigo, além desse exemplo dado da fila da lotérica. Agora, vamos ver alguns detalhes técnicos que essa função possui. 

Informações técnicas

Valor retornado

Após a adição de elementos feita com o push, o valor retornado é a nova quantidade de elementos que o array possui.

Changelog

Como a função foi evoluindo conforme as atualizações da linguagem, a partir da versão 7.3 do PHP, a invocação da função php array push pode ser feita apenas com o parâmetro array. 

Versão do PHP

Essa função pode ser utilizada a partir da versão 4 do PHP. Como as versões atuais estão maiores que a 7, não será um problema a parte de versionamento da linguagem. 

Dicas para aplicar ao usar a função PHP array push

Algumas dicas de como utilizar a função php array push da melhor forma:

  • Você não precisará utilizar essa função em cinco linhas de código para inserir um elemento por vez em um array. Você poderá colocar os cinco elementos em uma única chamada da função, para inserir eles por último na estrutura;
  • Utilizar nomes que sejam de fácil compreensão para arrays, para que outras pessoas consigam entender.

Já vimos o básico do que há de teoria com essa função. Agora, vamos explorá-la na prática.

5 exemplos da função PHP array push na prática!

  • Vamos ao exemplo 1, em um array de frutas: 
<?php

$frutas = ["Banana", "Maçã", "Uva"];

 

array_push($frutas, "Morango");

 

print_r($frutas);

 

?>

Em variáveis, no PHP, todas começam com o símbolo de cifrão ($), e, para a declaração de um array ser feita, é feita com colchetes ([]). 

Inicialmente, foi declarado um array com as frutas: Banana, Maçã e Uva. Mas, suponhamos que quero adicionar o Morango a eles também. Como faço?

Simples! Foi feito o uso da função push e, nela, foi passado o array $frutas como primeiro parâmetro e, o valor que desejo inserir, que, no caso, é o Morango. 

A função print_r, é basicamente para imprimir os valores de um array na tela. O resultado foi o seguinte: 

Resultado array frutas php array push

A impressão do array já contém o valor da fruta Morango adicionada ao final do array. 

  • Vamos ao exemplo 2, em um array de notas de um aluno: 
<?php

 

$notas = [9, 3, 5, 0];

 

array_push($notas, 8);

 

print_r($notas);

?>

Inicialmente, foi declarado um array com as notas: 9, 3, 5 e 0 e, eu quero adicionar a nota 8 também.

Para esse caso, foi feita a invocação da função php array push, passando o array $notas, como primeiro parâmetro e, o valor que desejo inserir que, no caso, é 8. 

O resultado foi o seguinte: 

Resultado php array push

A impressão do array já contém o valor 8 adicionado ao final do array. 

  • Vamos ao exemplo 3, em um array de linguagens de programação:
<?php

 

$linguagens = ["Java", "Ruby", "Scala", "PHP"];

 

array_push($linguagens, "C#");

 

print_r($linguagens);

 

?>

Para esse caso, foi feita a invocação da função php array push, passando o array $linguagens, como primeiro parâmetro e, o valor que desejo inserir que, no caso, é a linguagem C#

O resultado foi o seguinte: 

Array linguagens de programação

A impressão do array já contém o valor C# adicionado ao final do array das linguagens que rodam no servidor (back-end). 

  • Vamos ao exemplo 4, em um array de doces:
<?php

 

$doces = ["Chiclete", "Brigadeiro", "Pudim"];

 

array_push($doces, "Bombocado", "Bala", "Camafeu");

 

print_r($doces);

 

?>

Para esse caso, foi feita a invocação da função php array push, passando o array $doces, como primeiro parâmetro e, o valor que desejo inserir que, no caso, são os doces Bombocado, Bala e Camafeu

O resultado foi o seguinte: 

Resultado Array doces

A impressão do array já contém o valores Bombocado, Bala e Camafeu adicionados ao final do array. 

  • Vamos ao exemplo 5, em um array de cores:
<?php

 

$cores = array("cor1"=>"vermelho","cor2"=>"verde");

 

array_push($cores,"blue","yellow");

 

print_r($cores);

 

?>

Para esse caso, foi feita a invocação da função php array push, passando o array $cores, como primeiro parâmetro e, o valor que desejo inserir que, no caso, são os doces Azul e Amarelo.

O resultado foi o seguinte: 

Resultado php array push cores

A impressão do array já contém o valores Azul e Amarelo adicionados ao final do array. 

Muito bacana essa função, concorda? Ela permite que você adicione elementos ao final de um array. Você pode adicionar quantos elementos você quiser. Essa função push também pode existir em outras linguagens de programação, como Java, JavaScript, dentre outras, com nomes diferentes, mas o conceito é o mesmo, independentemente da linguagem.

Ela permite que você manipule vários formatos de dados, mas os que você mais utilizará no cotidiano são os formatos de texto (string) e valores numéricos (inteiros), conforme exibidos nos exemplos. 

Você quer aprofundar seus conhecimentos em PHP? Confira nosso texto sobre PHP For.