Resumo : neste tutorial, você aprenderá como usar a array_unshift()função PHP para preceder um ou mais elementos no início de um array.
Introdução à função array_unshift() do PHP
Para acrescentar um ou mais elementos a um array, você usa a array_unshift()função:
array_unshift ( array &$array , mixed ...$values ) : intLinguagem de código: PHP ( php )Nesta sintaxe:
$arrayé a matriz de entrada$valuessão os valores a serem acrescentados
O array_unshift()retorna o novo número de elementos na matriz.
Observe que a array_unshift()função modifica o array original. A array_unshift()função precede os elementos da matriz de entrada como um todo. Ele preserva os elementos prefixados.
Como a array_unshift()função adiciona os novos elementos ao início da matriz de entrada, ela altera os índices para começar do zero.
Exemplos de array_unshift() em PHP
Vejamos alguns exemplos de uso da array_unshift()função PHP.
1) Usando a função array_unshift() do PHP para preceder um elemento a um exemplo de array
O exemplo a seguir usa a array_unshift()função para preceder um elemento no início de uma matriz:
<?php
$permissions = [
'edit',
'delete',
'view'
];
array_unshift($permissions, 'new');
print_r($permissions);Linguagem de código: HTML, XML ( xml )Saída:
Array
(
[0] => new
[1] => edit
[2] => delete
[3] => view
)Linguagem de código: texto simples ( texto simples )Como funciona.
- Primeiro, defina um array com três elementos.
- Segundo, acrescente o
'new'elemento ao início da matriz. - Terceiro, mostre os elementos do array usando a
print_r()função.
Como você pode ver claramente na saída, o 'new'elemento obtém o índice zero enquanto os índices existentes mudam de acordo.
2) Usando a função array_unshift() do PHP para preceder um elemento a um exemplo de array
O exemplo a seguir usa o array_unshift()para acrescentar três elementos ao início de uma matriz:
<?php
$permissions = [
'edit',
'delete',
'view'
];
array_unshift($permissions, 'new', 'approve', 'reject');
print_r($permissions);Linguagem de código: HTML, XML ( xml )Saída:
Array
(
[0] => new
[1] => approve
[2] => reject
[3] => edit
[4] => delete
[5] => view
)Linguagem de código: texto simples ( texto simples )Anexando um elemento ao início de uma matriz associativa
Para preceder um elemento a uma matriz associativa, você usa o operador +. Por exemplo:
<?php
$colors = [
'red' => '#ff000',
'green' => '#00ff00',
'blue' => '#0000ff',
];
$colors = ['black' => '#000000'] + $colors;
print_r($colors);Linguagem de código: HTML, XML ( xml )Saída:
Array
(
[black] => #000000
[red] => #ff000
[green] => #00ff00
[blue] => #0000ff
)Linguagem de código: PHP ( php )Resumo
- Use a função PHP
array_prepend()para pré-prender um ou mais elementos no início de um array.
