array

(PHP 3, PHP 4 )

array --  Crea un array

Descrizione

array array ( [mixed ...])

Restituisce un array contenente i parametri. Ai parametri si può dare un indice con l'operatore =>.

Nota: array() è un costrutto del linguaggio usato per rappresentare array letterali, e non una normale funzione.

La sintassi "indice => valori", separati da virgole, definisce indici e valori. indice può essere di tipo string o numerico. Quando l'indice è omesso, viene generato automaticamente un indice intero, a partire da 0. Se l'indice è un intero, il successivo indice generato sarà l'indice intero più grande + 1. Si noti che quando due indici identici vengono definiti, l'ultimo sovrascrive il primo.

L'esempio seguente dimostra come creare un array bidimensionale, come specificare le chiavi per gli array associativi, e come modificare la serie degli indici numerici negli array normali.

Esempio 1. Esempio di array()

$frutta = array (
    "frutta"  => array ("a"=>"arancia", "b"=>"banana", "c"=>"mela"),
    "numeri" => array (1, 2, 3, 4, 5, 6),
    "buche"   => array ("prima", 5 => "seconda", "terza")
);

Esempio 2. Indice automatico con array()

$array = array( 1, 1, 1, 1,  1, 8=>1,  4=>1, 19, 3=>13);
print_r($array);

che stamperà:
Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

Si noti che l'indice '3' è definito due volte, e che mantiene il valore finale 13. L'indice 4 è definito dopo l'indice 8, e il successivo indice generato (valore 19) è 9, dal momento che l'indice più grande era 8.

Questo esempio crea un array che parte da 1 (1-based).

Esempio 3. Indice 1-based con array()

$primotrimestre  = array(1 => 'Gennaio', 'Febbraio', 'Marzo');
        print_r($primotrimestre);

che stamperà:
Array
(
    [1] => Gennaio
    [2] => Febbraio
    [3] => Marzo
)

Vedere anche array_pad(), list() e range()