array

(unknown)

array --  Erstellt ein Array

Beschreibung

array array ( [mixed ...])

Gibt ein den Parametern entsprechendes Array zurück. Mit dem => Operator können die Parameter indiziert werden.

Anmerkung: array() ist keine richtige Funktion sondern ein Sprachkonstrukt, das zur Erzeugung eines Wertefeldes genutzt wird.

Die Syntax "Index => Werte", durch Kommas getrennt, definiert Index und Werte. Index kann vom Typ String oder numerisch sein. Wird der Index weggelassen, erstellt die Funktion automatisch einen numerischen Index, der bei 0 beginnt. Ist der Index als Integer-Wert angegeben, wird der nächste generierte Index der größte Integer Index + 1. Beachten Sie, dass wenn zwei identische Indexe definiert sind, der letzte den ersten überschreibt.

Das folgende Beispiel zeigt wie man ein zweidimensionales Array erstellt, wie man Schlüssel für assoziative Arrays festlegt, und wie man numerische Indizes in normalen Arrays überspringt und fortsetzt.

Beispiel 1. array()

$fruits = array (
    "Früchte" => array ("a"=>"Orange", "b"=>"Banane", "c"=>"Apfel"),
    "Zahlen"  => array (1, 2, 3, 4, 5, 6),
    "Löcher"  => array ("erstes", 5 => "zweites", "drittes")
);

Beispiel 2. Automatischer Index mit array()

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

wird folgendes anzeigen:
Array
(
    [0] => 1
    [1] => 1
    [2] => 1
    [3] => 13
    [4] => 1
    [8] => 1
    [9] => 19
)

Beachten Sie, dass Index '3' doppelt definiert ist, und den letzten definierten Wert 13 behält. Index 4 wurde nach dem Index 8 definiert, und der nächste generierte Index (Wert 19) ist 9, da der größte Index 8 war.

Dieses Beispiel erstellt ein auf dem Index 1 basierendes Array.

Beispiel 3. 1-basierter Index mit array()

$erstesquartal  = array(1 => 'Januar', 'Februar', 'März');
print_r($erstesquartal);

wird folgendes ausgeben:
Array
(
    [1] => 'Januar'
    [2] => 'Februar'
    [3] => 'März'
)

Siehe auch array_pad(), list() und range().