length (Array.length-Eigenschaft)

Eine nicht negative Ganzzahl, die die Anzahl von Elementen im Array angibt. Diese Eigenschaft wird automatisch aktualisiert, wenn dem Array neue Elemente hinzugefügt werden. Sobald Sie einem Array-Element einen Wert zuweisen (z. B. my_array[index] = value) und wenn index eine Zahl und index+1 größer als die length-Eigenschaft ist, wird die length-Eigenschaft auf index+1 aktualisiert.

Hinweis: Wenn Sie der length-Eigenschaft einen Wert zuweisen, der kleiner ist als die tatsächliche Länge des Arrays, wird das Array abgeschnitten.

Beispiel

Aus dem folgenden Code geht hervor, wie die length-Eigenschaft aktualisiert wird. Die Ausgangslänge ist 0 und wird anschließend auf 1, 2 und 10 aktualisiert. Wenn Sie der length-Eigenschaft einen Wert zuweisen, der kleiner ist als die tatsächliche Länge des Arrays, wird das Array abgeschnitten.

var my_array:Array = new Array(); 
trace(my_array.length); // Ausgangslänge ist 0
my_array[0] = "a";
trace(my_array.length); // "my_array.length" wurde auf 1 aktualisiert
my_array[1] = "b";
trace(my_array.length); // "my_array.length" wurde auf 2 aktualisiert
my_array[9] = "c";
trace(my_array.length); // "my_array.length" wurde auf 10 aktualisiert
trace(my_array);
// Anzeige: 
// a,b,undefined,undefined,undefined,undefined,undefined,undefined,undefined,c

// durch das Setzen der "length2-Eigenschaft auf 5 wird das Array abgeschnitten
my_array.length = 5;
trace(my_array.length); // "my_array.length" wurde auf 5 aktualisiert
trace(my_array); // Ausgabe: a,b,undefined,undefined,undefined