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.

Retorna o novo número de elementos de array.

Exemplo 1. Exemplo de array_unshift()

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

O programa acima resultaria em $queue contendo os seguintes elementos:

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

Veja também array_shift(), array_push() e array_pop().