length (propriété Array.length)

Un entier non négatif spécifiant le nombre d'éléments contenus dans le tableau. Cette propriété est automatiquement mise à jour lorsque vous ajoutez de nouveaux éléments dans le tableau. Lorsque vous affectez une valeur à un élément de tableau (par exemple, my_array[index] = value), si index est un nombre et si index+1 est supérieur à la propriété length, la propriété length est mise à jour et définie sur la valeur index+1.

Remarque : Si vous affectez une valeur plus courte que la valeur existante à la propriété length, le tableau sera tronqué.

Exemple

Le code suivant explique la façon dont la propriété length est mise à jour. La valeur de la longueur initiale est 0, puis 1, 2 et 10. Si vous affectez une valeur plus courte que la valeur existante à la propriété length, le tableau sera tronqué :

var my_array:Array = new Array(); 
trace(my_array.length); // Longueur initiale de 0
my_array[0] = "a";
trace(my_array.length); // my_array.length prend la valeur 1
my_array[1] = "b";
trace(my_array.length); // my_array.length prend la valeur 2
my_array[9] = "c";
trace(my_array.length); // my_array.length prend la valeur 10
trace(my_array); 
// Affiche : 
// a,b,undefined,undefined,undefined,undefined,undefined,undefined,undefined,c

// si la propriété length est définie sur 5, le tableau est tronqué
my_array.length = 5; 
trace(my_array.length); // my_array.length prend la valeur 5
trace(my_array); // Renvoie : a,b,undefined,undefined,undefined