Flash Lite 2

Flash Lite 2.x ActionScript-Referenzhandbuch > Elemente der ActionScript-Sprache > Globale Funktionen > Array-Funktion

Array-Funktion

Array(): Array Array(numElements:Number): Array Array( [element0:Object [, element1, element2, ...elementN] ]) : Array

Erstellt ein neues Array mit einer Länge von 0 oder länger bzw. ein Array, das anhand einer Liste mit angegebenen Elementen, möglicherweise unterschiedlichen Datentyps, gefüllt wird.

Mit dieser Funktion können Sie Folgendes erstellen:

• Leere Arrays
• Arrays mit einer bestimmten Länge, deren Elemente jedoch undefinierte Werte haben
• Arrays, deren Elemente spezifische Werte aufweisen

Die Verwendung dieser Funktion ähnelt dem Erstellen eines Arrays mit dem Array-Konstruktor (siehe Konstruktor für die Array-Klasse).

Sie können die Anzahl der Elemente übergeben (numElements) oder eine Liste der Elemente, die auch unterschiedliche Datentypen enthalten kann (element0, element1, ... elementN).

Parameter, die mehr als einen Datentyp annehmen können, werden wie in der Syntax mit dem Typ Object aufgeführt.

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

numElements [optional] - Eine positive Ganzzahl, die die Anzahl von Elementen im Array angibt. Sie können entweder numElements angeben oder eine Liste der Elemente, jedoch nicht beides.

elementN [optional] - Ein oder auch mehrere Parameter, element0, element1, ... , elementN, deren Werte beliebige Datentypen annehmen können. Parameter, die mehrere Datentypen annehmen können, werden als Object-Typ hinzugefügt. Sie können entweder numElements angeben oder eine Liste der Elemente, jedoch nicht beides.

Rückgabewerte

Array - Ein Array.

Beispiel

var myArray:Array = Array();
myArray.push(12);
trace(myArray); // Ausgabe: 12
myArray[4] = 7;
trace(myArray); // Ausgabe: 12,undefined,undefined,undefined,7

Verwendung 2: Im folgenden Beispiel wird ein Array mit der Länge 4, jedoch ohne Elementdefinition erstellt:

var myArray:Array = Array(4);
trace(myArray.length); // Ausgabe: 4
trace(myArray); // Ausgabe: undefined,undefined,undefined,undefined

Verwendung 3: Im folgenden Beispiel wird ein Array mit drei Elementdefinitionen erstellt:

var myArray:Array = Array("firstElement", "secondElement", "thirdElement");
trace (myArray); // Ausgabe: firstElement,secondElement,thirdElement
Im Gegensatz zum Klassenkonstruktor Array verwendet die Funktion Array() nicht das Schlüsselwort new.

Siehe auch

Array