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

down

118

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