length, propriété (Array)
Retourne une valeur entière correspondant à une unité de plus que l'indice d'élément le plus élevé d'un tableau.
arrayObj.length
Arguments
- arrayObj
Obligatoire. Tout objet Array.
Notes
Les éléments d'un tableau JScript n'étant pas obligatoirement contigus, la propriété length ne correspond pas nécessairement au nombre d'éléments du tableau.
Si une valeur plus petite que sa valeur précédente est assignée à la propriété length, le tableau est tronqué et tous les éléments ayant des indices de tableau égaux ou supérieurs à la nouvelle valeur de la propriété length sont perdus.
Si une valeur plus grande que sa valeur précédente est assignée à la propriété length, le tableau est agrandi du point de vue de la forme, mais aucun nouvel élément n'est créé.
Exemple
L'exemple ci-dessous illustre l'utilisation de la propriété length.
var s = "";
var arr = new Array(10, 11, "abc", "def");
for (var i = 0; i < arr.length; i++)
{
s += arr[i] + " ";
}
// Output: 10 11 abc def
Dans l'exemple suivant, un tableau est déclaré et deux éléments lui sont ajoutés. 6 étant l'index le plus élevé du tableau, la longueur est 7.
var my_array = new Array();
my_array[2] = "Test";
my_array[6] = "Another Test";
var s = my_array.length;
// Output: 7