Resumo : neste tutorial você aprenderá como usar a array_shift()
função PHP para remover um elemento do início de um array.
Introdução à função array_shift do PHP
A array_shift()
função remove o primeiro elemento de um array e o retorna.
O seguinte mostra a sintaxe da array_shift()
função:
array_shift(array &$array): mixed
Linguagem de código: PHP ( php )
Nesta sintaxe, $array
é o array de entrada do qual você deseja remover o primeiro elemento.
Se $array
estiver vazio ou não for um array, a array_shift()
função retornará null
.
Observe que a array_shift()
função altera a matriz de entrada encurtando-a em um elemento. Ele também modifica as chaves numéricas do array para que o primeiro elemento do array modificado tenha uma chave começando do zero.
Para remover um elemento do final de um array e retorná-lo, você usa a array_pop()
função.
Exemplo de função PHP array_shift()
O exemplo a seguir usa a array_shift()
função para remover o primeiro elemento de uma matriz:
<?php
$numbers = [1, 2, 3];
$first_number = array_shift($numbers);
print_r($numbers);
Linguagem de código: HTML, XML ( xml )
Saída:
Array
(
[0] => 2
[1] => 3
)
Linguagem de código: PHP ( php )
Como funciona.
- Primeiro, defina uma matriz que tenha três números 1, 2 e 3.
- Segundo, remova o primeiro elemento do
$numbers
array e atribua-o à$first_number
variável. - Terceiro, mostre os elementos do
$numbers
array.
Como você pode ver claramente na saída, o $numbers
array foi alterado de 3 elementos para 2 elementos. Além disso, os índices do array $numbers também são alterados.
Como é array_shift()
necessário reindexar o array após remover o primeiro elemento, a função será bastante lenta se o array de entrada for grande.
Resumo
- Use a função PHP
array_shift()
para remover um array do início de um array e retorná-lo.