Flash Lite 2

Flash Lite 2.x ActionScript-Referenzhandbuch > ActionScript-Klassen > Array > Array-Konstruktor

Array-Konstruktor

Dient zur Erstellung eines Arrays. Mit diesem Konstruktor können Sie unterschiedliche Array-Typen erstellen: leere Arrays, Arrays mit einer bestimmten Länge, deren Elemente undefinierte Werte aufweisen, oder Arrays, deren Elemente spezifische Werte aufweisen.

Verwendung 1: Wenn Sie keine Parameter angeben, wird ein Array mit der Länge 0 erstellt.

Verwendung 2: Wenn Sie nur eine Länge angeben, wird ein Array mit der durch den Parameter length angegebenen Anzahl von Elementen erstellt. Der Wert dieser Elemente wird mit undefined festgelegt.

Verwendung 3: Wenn Sie mit den element-Parametern Werte angeben, wird ein Array mit spezifischen Werten erstellt.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

value:Object [optional] - Zwei Möglichkeiten:

• Eine Ganzzahl, die die Anzahl von Elementen im Array angibt.
• Eine Liste mit mindestens zwei beliebigen Werten, deren Werte die Typen Boolean, Number, String, Object oder Array annehmen können. Das erste Element in einem Array hat den Index oder die Position 0.

Hinweis: Wird dem Array-Konstruktor nur ein numerischer Parameter übergeben, wird dieser als length interpretiert und mithilfe der Integer()-Funktion in eine Ganzzahl umgewandelt.

Beispiel

Verwendung 1: Im folgenden Beispiel wird ein neues Array-Objekt mit der Ausgangslänge 0 erstellt:

var my_array:Array = new Array(); 
trace(my_array.length); // Ausgabe: 0

Verwendung 2: Im folgenden Beispiel wird ein neues Array-Objekt mit der Ausgangslänge 4 erstellt:

var my_array:Array = new Array(4);
trace(my_array.length); // Rückgabewert: 4
trace(my_array[0]); // Rückgabewert: undefined
if (my_array[0] == undefined) { // keine Anführungszeichen um undefined
    trace("undefined is a special value, not a string");
} // Ausgabe: undefined is a special value, not a string.

Verwendung 3: Im folgenden Beispiel wird das neue Array-Objekt go_gos_array mit der Ausgangslänge 5 erstellt:

var go_gos_array:Array = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
trace(go_gos_array.length); // Rückgabewert: 5
trace(go_gos_array.join(", ")); // Elemente anzeigen

Aus dem folgenden Beispiel geht hervor, wie die Ausgangselemente des Arrays go_gos_array festgelegt werden:

go_gos_array[0] = "Belinda";
go_gos_array[1] = "Gina";
go_gos_array[2] = "Kathy";
go_gos_array[3] = "Charlotte";
go_gos_array[4] = "Jane";

Mit dem folgenden Code wird ein sechstes Element zum Array go_gos_array hinzugefügt und das zweite Element geändert:

go_gos_array[5] = "Donna";
go_gos_array[1] = "Nina"
trace(go_gos_array.join(" + "));
// Rückgabewert: Belinda + Nina + Kathy + Charlotte + Jane + Donna

Siehe auch

[] Array-Zugriffsoperator, length (Array.length-Eigenschaft)