array_unshift

(PHP 4, PHP 5)

array_unshift — Adiciona um ou mais elementos no início de um array

Descrição

int array_unshift ( array &$array , mixed $var [, mixed $... ] )

array_unshift() adiciona os elementos passados como argumentos no início de array. Note que a lista de elementos é adicionada como um todo, de forma que eles ficam na mesma ordem. Todas as chaves numéricas serão modificadas para começar a contar de 0 (zero) enquanto chaves strings permanecerão inalteradas.

Parâmetros

array: O array de entrada.
var: A variável a ser adicionada.

Valor Retornado

Retorna o novo número de elementos em array.

Exemplos

Example #1 Exemplo de array_unshift()


<?php
$cesta = array("laranja", "banana");
array_unshift($cesta, "melancia", "morango");
print_r($cesta);
?>

O exemplo acima irá imprimir:

Array
(
    [0] => melancia
    [1] => morango
    [2] => laranja
    [3] => banana
)

Veja Também

array_shift() - Retira o primeiro elemento de um array
array_push() - Adiciona um ou mais elementos no final de um array
array_pop() - Retira um elemento do final do array