Manual do PHP
Anterior |  | Próxima

# 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().

Anterior | Principal | Próxima
array_walk | Acima | arsort