array
(PHP 4, PHP 5)
array — Cria um array
Descrição
Retorna um array a partir dos valores fornecidos. Índices podem ser atribuidos aos valores através do operador =>. leia a seção sobre o tipo array(matriz) para maiores informações sobre o que é uma matriz.
Nota: array() é uma estrutura utilizada para representar literais de arrays, e não uma função.
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.
Example#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")
);
?>
Example#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.
Example#3 Array com índices a partir do 1 com array()
<?php
$firstquarter = array(1 => 'January', 'February','March');
print_r($firstquarter);
?>
O exemplo acima irá imprimir:
Array ( [1] => Janeiro [2] => Fevereiro [3] => Marco )
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.
Example#4 Acessando uma matriz dentro de conchetes
<?php
$foo = array('bar' => 'baz');
echo "Hello {$foo['bar']}!"; // Hello baz!
?>
Veja também array_pad(), list(), foreach e range().