Função array_unshift() PHP

Funções de Array do PHP

Exemplo

Inserir o elemento "blue" no array:

<?php
$a=array("a"=>"red","b"=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Executar Exemplo

Definição e Uso

A função array_unshift() é usada para inserir novos elementos em um array. O valor do novo array será inserido no início do array.

Os elementos adicionados serão adicionados como um todo, mantendo a ordem dos elementos na lista de parâmetros.

Esta função retornará o número de elementos no array.

Dica:Você pode inserir um ou mais valores.

Comentário:Os nomes de chave numéricos começarão em 0 e aumentarão em 1. Os nomes de chave de string permanecerão inalterados.

Sintaxe

array_unshift(array,value1,value2,value3...)
Parâmetros Descrição
array Obrigatório. Especifica o array.
value1 Obrigatório. Especifica o valor a ser inserido.
value2 Opcional. Especifica o valor a ser inserido.
value3 Opcional. Especifica o valor a ser inserido.

Detalhes Técnicos

Retorno: Retorna o número de novos elementos no array.
Versão PHP: 4+

Mais Exemplos

Exemplo 1

Mostrar valor retornado:

<?php
$a=array("a"=>"red","b"=>"green");
print_r(array_unshift($a,"blue"));
?>

Executar Exemplo

Exemplo 2

Uso de chaves numéricas:

<?php
$a=array(0=>"red",1=>"green");
array_unshift($a,"blue");
print_r($a);
?>

Executar Exemplo

Funções de Array do PHP