array

(PHP 3, PHP 4, PHP 5 )

array --  Cria um array

Descrição

array array ( [mixed ...] )

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.

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);
?>

Vai mostrar:

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 => 'January', 'February','March');
print_r($firstquarter);
?>

Vai mostrar:

Array 
(
    [1] => Janeiro
    [2] => Fevereiro
    [3] => Marco
)

Veja também array_pad(), list(), foreach e range().