(PHP 4, PHP 5, PHP 7)
array — Cria um array
Cria um array. Leia a seção sobre o tipo array para mais informação sobre o que é um array.
...A sintaxe "index => values", separados por vírgulas, definem índice e valores respectivamente. O índice por de ser do tipo string ou numérico. Quando o índice é omitido, um índice numérico inteiro é automaticamente gerado, começando do 0. Se o índice é um inteiro, o próximo índice a ser gerado será igual ao maior índice inteiro + 1. Note que quando dois índices idênticos são definidos, o último sobrescreve o primeiro.
O exemplo a seguir demonstra como criar um array com duas dimensões, como especificar chaves em arrays associativos, e como definir índices numéricos em arrays normais. Tem uma vírgula após a ultima entrada definida da matriz, mesmo sendo incomum, é uma sintaxe válida.
Retorna um array dos parâmetros. Os parâmetros podem ser dados com um índice com o operador =>. Leia a seção sobre o tipo array para mais informação sobre o que ele é.
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 irá imprimir:
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 depois dele foi 9, uma vez que o maior índice era 8.
Esse exemplo cria um array com o índices a partir do 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 irá imprimir:
Array
(
[1] => Janeiro
[2] => Fevereiro
[3] => Março
)
Como no Perl, você pode acessar o valor de um array dentro de aspas. Entretanto, você terá que colocar a sua array dentro de conchetes.
Exemplo #4 Acessando uma matriz dentro de conchetes
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
Nota:
array() é um construtor da linguagem usado para representar arrays literais, e não um função normal.