Array


Object
    |
    +-Array

public dynamic class Array
extends Object

Die Array-Klasse ermöglicht den Zugriff und die Bearbeitung von indizierten Arrays. Ein indiziertes Array ist ein Objekt, dessen Eigenschaften durch eine Zahl angegeben werden, die für die entsprechende Position im Array steht. Diese Zahl wird auch als Index bezeichnet. Alle indizierten Arrays basieren auf Null, d. h., das erste Element im Array ist [0], das zweite Element [1] usw. Verwenden Sie zum Erstellen eines Array-Objekts den Konstruktor new Array(). Der Zugriff auf die Elemente eines Arrays wird mithilfe des Array-Zugriffsoperators ([]) ermöglicht.

Sie können viele unterschiedliche Datentypen in einem Array-Element speichern, z. B. Zahlen, Strings, Objekte und auch andere Arrays. Außerdem haben Sie die Möglichkeit, ein mehrdimensionales Array zu erstellen, indem Sie ein indiziertes Array anlegen und jedem seiner Elemente ein weiteres indiziertes Array zuweisen. Diese Arrays werden als mehrdimensional bezeichnet, da sie zur Darstellung von Daten in einer Tabelle verwendet werden können.

Die Zuweisung von Arrays erfolgt nicht mithilfe von Werten, sondern über Verweise: Wenn Sie eine Array-Variable einer anderen zuweisen, referenzieren beide Variablen das gleiche Array:

var oneArray:Array = new Array("a", "b", "c");
var twoArray:Array = oneArray; // beide Array-Variablen verweisen auf dasselbe Array
twoArray[0] = "z";
trace(oneArray); // Ausgabe: z,b,c.

Allerdings sollten Sie mithilfe der Array-Klasse keine assoziativen Arrays erstellen, bei denen es sich um unterschiedliche Datenstrukturen mit bezeichneten statt nummerierten Elementen handelt. Assoziative Arrays (die auch als Hashes bezeichnet werden) lassen sich am besten mit der Object-Klasse erstellen. ActionScript ermöglicht zwar auch das Erstellen assoziativer Arrays mithilfe der Array-Klasse, Sie können dann jedoch keine der Methoden oder Eigenschaften der Array-Klasse verwenden. Im Grunde ist ein assoziatives Array eine Instanz der Object-Klasse, bei der jedes Schlüssel-Werte-Paar durch eine Eigenschaft und deren Wert dargestellt wird. Ein weiterer Grund für die Deklaration eines assoziativen Arrays als Object-Datentyp besteht darin, dass das assoziative Array auf diese Weise mithilfe von Objektliteralen mit Daten versehen werden kann (wenn auch nur unmittelbar bei seiner Erstellung). Im folgenden Beispiel wird ein assoziatives Array mit einem Objektliteral erstellt. Der anschließende Zugriff auf dessen Elemente erfolgt sowohl mit dem Punkt (.)- als auch mit dem Array-Zugriffsoperator. Anschließend wird durch Erstellen einer neuen Eigenschaft ein neues Schlüssel-Werte-Paar hinzugefügt:

var myAssocArray:Object = {fname:"John", lname:"Public"};
trace(myAssocArray.fname); // Ausgabe: John
trace(myAssocArray["lname"]); // Ausgabe: Public
myAssocArray.initial = "Q";
trace(myAssocArray.initial); // Ausgabe: Q

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0. Ab Flash Player 6 ein natives Objekt bei deutlicher Leistungsverbesserung.

Beispiel

Im folgenden Beispiel enthält my_array vier Monate des Jahres:

var my_array:Array = new Array(); 
my_array[0] = "January";
my_array[1] = "February";
my_array[2] = "March";
my_array[3] = "April";

Übersicht über Eigenschaften

Modifizierer	Eigenschaft	Beschreibung
`static`	CASEINSENSITIVE`:`Number	Gibt die Sortierung ohne Berücksichtigung der Groß- und Kleinschreibung an.
`static`	DESCENDING`:`Number	Gibt eine absteigende Sortierreihenfolge an.
	length`:`Number	Eine nicht negative Ganzzahl, die die Anzahl von Elementen im Array angibt.
`static`	NUMERIC`:`Number	Gibt die numerische Sortierung anstelle der stringbasierten Sortierung an.
`static`	RETURNINDEXEDARRAY`:`Number	Gibt die Option an, dass als Ergebnis des Aufrufs der `sort()`- oder `sortOn()`-Methode ein indiziertes Array zurückgegeben wird.
`static`	UNIQUESORT`:`Number	Gibt die Anforderung für eine eindeutige Sortierung an.

Von der Object-Klasse vererbte Eigenschaften

constructor (Object.constructor-Eigenschaft), __proto__ (Object.__proto__-Eigenschaft), prototype (Object.prototype-Eigenschaft), __resolve (Object.__resolve-Eigenschaft)

Übersicht über Konstruktoren

Syntax	Beschreibung
Array`([value:`Object`])`	Dient zur Erstellung eines Arrays.

Übersicht über Methoden

Modifizierer	Syntax	Beschreibung
	concat`([value:`Object`]) :` Array	Verkettet die in den Parametern angegebenen Elemente mit den Elementen in einem Array und erstellt ein neues Array.
	join`([delimiter:`String`]) :` String	Wandelt die Elemente in einem Array in Strings um, fügt zwischen ihnen das angegebene Trennzeichen ein, verkettet die Elemente und gibt den resultierenden String zurück.
	pop`() :` Object	Entfernt das letzte Element aus einem Array und gibt den Wert dieses Elements zurück.
	push`(value:`Object`) :` Number	Fügt am Ende eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück.
	reverse`() :` Void	Kehrt die Reihenfolge der Array-Elemente im Array um.
	shift`() :` Object	Entfernt das erste Element aus einem Array und gibt dieses Element zurück.
	slice`([startIndex:`Number`], [endIndex:`Number`]) :` Array	Gibt ein neues Array zurück, das aus mehreren Elementen des ursprünglichen Arrays besteht, ohne das ursprüngliche Array dabei zu ändern.
	sort`([compareFunction:`Object`], [options:`Number`]) :` Array	Sortiert die Elemente in einem Array.
	sortOn`(fieldName:`Object`, [options:`Object`]) :` Array	Sortiert die Elemente in einem Array nach mindestens einem Feld im Array.
	splice`(startIndex:`Number`, [deleteCount:`Number`], [value:`Object`]) :` Array	Fügt einem Array Elemente hinzu bzw. entfernt diese.
	toString`() :` String	Gibt einen Stringwert mit den Elementen des angegebenen Array-Objekts zurück.
	unshift`(value:`Object`) :` Number	Fügt am Anfang eines Arrays ein oder mehrere Elemente hinzu und gibt die neue Länge des Arrays zurück.

Von der Object-Klasse vererbte Methoden

addProperty (Object.addProperty-Methode), hasOwnProperty (Object.hasOwnProperty-Methode), isPropertyEnumerable (Object.isPropertyEnumerable-Methode), isPrototypeOf (Object.isPrototypeOf-Methode), registerClass (Object.registerClass-Methode), toString (Object.toString-Methode), unwatch (Object.unwatch-Methode), valueOf (Object.valueOf-Methode), watch (Object.watch-Methode)