array_unshift

    (PHP 4, PHP 5, PHP 7, PHP 8)

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

    Descrição

    array_unshift(array&$array, mixed...$values): int

    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 zero enquanto chaves literais permanecerão inalteradas.

    Nota:

    Redefine o ponteiro interno do array para o primeiro elemento.

    Parâmetros

    array

    O array de entrada.

    values

    Os valores a serem adicionados.

    Valor Retornado

    Retorna o novo número de elementos em array.

    Registro de Alterações

    VersãoDescrição
    7.3.0 Essa função agora pode ser chamada com apenas um parâmetro. Anteriomente, pelo menos dois parâmetros eram necessários.

    Exemplos

    Exemplo #1 Exemplo de array_unshift()

    <?php
    $cesta     = [
    "laranja",
    "banana"
    ];

    array_unshift($cesta, "melancia", "morango");
    var_dump($cesta);
    ?>

    O exemplo acima produzirá:

    array(4) { [0] => string(8) "melancia" [1] => string(7) "morango" [2] => string(7) "laranja" [3] => string(6) "banana" }

    Exemplo #2 Uso de arrays associativos

    Se um array associativo é pre anexado a outro array associativo, o array anexado é numeralmente indexado no array anterior.

    <?php
    $frutas     = [
    'maca' => [
    'McIntosh' => 'vermelho',
    'Granny Smith' => 'verde',
    ],
    'laranja' => [
    'Navel' => 'laranja',
    'Valencia' => 'laranja',
    ],
    ];
    $vegetais = [
    'alface' => [
    'Iceberg' => 'verde',
    'Butterhead' => 'verde',
    ],
    'cenoura' => [
    'Deep Purple Hybrid' => 'roxo',
    'Imperator' => 'laranja',
    ],
    'pepino' => [
    'Kirby' => 'verde',
    'Gherkin' => 'verde',
    ],
    ];

    array_unshift($frutas, $vegetais);
    var_dump($frutas);

    O exemplo acima produzirá:

    array(3) { [0] => array(3) { 'alface' => array(2) { 'Iceberg' => string(5) "verde" 'Butterhead' => string(5) "verde" } 'cenoura' => array(2) { 'Deep Purple Hybrid' => string(4) "roxo" 'Imperator' => string(7) "laranja" } 'pepino' => array(2) { 'Kirby' => string(5) "verde" 'Gherkin' => string(5) "verde" } } 'maca' => array(2) { 'McIntosh' => string(8) "vermelho" 'Granny Smith' => string(5) "verde" } 'laranja' => array(2) { 'Navel' => string(7) "laranja" 'Valencia' => string(7) "laranja" } }

    Veja Também

    To Top