array

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

    array — Cria um array

    Descrição

    array(mixed ...$values): array

    Cria um array. Leia a seção sobre o tipo array para mais informação sobre o que é um array, incluindo detalhes sobre a sintaxe alternativa de colchetes ([]).

    Parâmetros

    values

    A sintaxe "índice => valores", separados por vírgulas, definem índice e valores respectivamente. O índice pode ser do tipo string ou inteiro. Quando o índice é omitido, um índice inteiro é automaticamente gerado, começando em 0. Se o índice é um inteiro, o próximo índice gerado será igual ao maior índice inteiro + 1. Note que quando dois índices idênticos são definidos, o último sobrescreve o primeiro.

    Inserir uma vírgula após a última entrada definida do array, mesmo sendo incomum, é uma sintaxe válida.

    Valor Retornado

    Retorna um array dos parâmetros. Os parâmetros podem ser fornecidos com um índice com o operador =>. Leia a seção sobre tipo de array para mais informação sobre o que é um array.

    Exemplos

    O exemplo a seguir demonstra como criar um array de duas dimensões, como especificar chaves para arrays associativos, e como pular e continuar índices numéricos em arrays normais.

    Exemplo #1 Exemplo de array()

    <?php
    $frutas     = array (
    "frutas" => array("a" => "laranja", "b" => "banana", "c" => "maçã"),
    "numeros" => array(1, 2, 3, 4, 5, 6),
    "buracos" => array("primeiro", 5 => "segundo", "terceiro")
    );
    ?>

    Exemplo #2 Indexação automática com array()

    <?php
    $array     = array(1, 1, 1, 1, 1, 8 => 1, 4 => 1, 19, 3 => 13);
    print_r($array);
    ?>

    O exemplo acima produzirá:

    Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

    Note que o índice 3 é definido duas vezes, e retêm seu último valor 13. O índice 4 é definido depois do índice 8, e o índice gerado a seguir (valor 19) é 9, uma vez que o maior índice era 8.

    Esse exemplo cria um array com o índices iniciando em 1.

    Exemplo #3 Array com índices a partir do 1 com array()

    <?php
    $firstquarter     = array(1 => 'Janeiro', 'Fevereiro', 'Março');
    print_r($firstquarter);
    ?>

    O exemplo acima produzirá:

    Array
(
    [1] => Janeiro
    [2] => Fevereiro
    [3] => Março
)

    Como no Perl, pode-se acessar o valor de um array dentro de aspas. Entretanto, com o PHP é necessário envolver o array entre chaves {}.

    Exemplo #4 Acessando um array dentro de chaves

    <?php

    $foo     = array('bar' => 'baz');
    echo     "Hello {$foo['bar']}!"; // Hello baz!

    ?>

    Notas

    Nota:

    array() é um construtor de linguagem usado para representar arrays literais, e não uma função normal.

    Veja Também

    • array_pad() - Expande um array para um certo comprimento utilizando um determinado valor
    • list() - Cria variáveis como se fossem arrays
    • count() - Conta todos os elementos de um array ou de um objeto Countable
    • range() - Cria um array contendo uma faixa de elementos
    • foreach
    • O tipo array

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 1 note

    up
    117
    ole dot aanensen at gmail dot com
    10 years ago
    As of PHP 5.4.x you can now use 'short syntax arrays' which eliminates the need of this function.

    Example #1 'short syntax array'
    <?php
    $a     = [1, 2, 3, 4];
    print_r($a);
    ?>

    The above example will output:
    Array
    (
    [0] => 1
    [1] => 2
    [2] => 3
    [3] => 4
    )

    Example #2 'short syntax associative array'
    <?php
    $a     = ['one' => 1, 'two' => 2, 'three' => 3, 'four' => 4];
    print_r($a);
    ?>

    The above example will output:
    Array
    (
    [one] => 1
    [two] => 2
    [three] => 3
    [four] => 4
    )
    ＋adicione uma nota
    To Top