Funções PHP |
. Glossários Funções PHP - array ( ) |
(PHP 3, PHP 4, PHP 5 )
array -- Cria um array
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
Exemplo:
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().