From bf8e099b9c8b3c60d60b3712b4fc97b052c39887 Mon Sep 17 00:00:00 2001 From: julieng Date: Tue, 3 Aug 2021 08:03:23 +0200 Subject: convert content to md --- .../reference/global_objects/array/length/index.md | 119 +++++++++------------ 1 file changed, 49 insertions(+), 70 deletions(-) (limited to 'files/fr/web/javascript/reference/global_objects/array/length') diff --git a/files/fr/web/javascript/reference/global_objects/array/length/index.md b/files/fr/web/javascript/reference/global_objects/array/length/index.md index 4e05fe8940..caa912f99a 100644 --- a/files/fr/web/javascript/reference/global_objects/array/length/index.md +++ b/files/fr/web/javascript/reference/global_objects/array/length/index.md @@ -9,19 +9,18 @@ tags: translation_of: Web/JavaScript/Reference/Global_Objects/Array/length original_slug: Web/JavaScript/Reference/Objets_globaux/Array/length --- -
{{JSRef}}
+{{JSRef}} -

La propriété length (longueur) est un entier non-signé de 32 bits qui indique le nombre d'éléments présents dans le tableau. Elle est toujours supérieure au plus grand indice du tableau.

+La propriété **`length`** (longueur) est un entier non-signé de 32 bits qui indique le nombre d'éléments présents dans le tableau. Elle est toujours supérieure au plus grand indice du tableau. -
{{EmbedInteractiveExample("pages/js/array-length.html")}}
+{{EmbedInteractiveExample("pages/js/array-length.html")}} +## Description +La valeur de la propriété `length` est un entier de signe positif dont la valeur est inférieure à 2 à la puissance 32 (2^32). -

Description

- -

La valeur de la propriété length est un entier de signe positif dont la valeur est inférieure à 2 à la puissance 32 (2^32).

- -
var tableauA = new Array(4294967296); // 2 à la puissance 32 = 4294967296
+```js
+var tableauA = new Array(4294967296); // 2 à la puissance 32 = 4294967296
 var tableauC = new Array(-100) // une valeur négative
 
 console.log(tableauA.length); // RangeError: Invalid array length
@@ -30,91 +29,71 @@ console.log(tableauC.length); // RangeError: Invalid array length
 var tableauB = [];
 tableauB.length = Math.pow(2,32)-1; // On déclare une longueur inférieure à 2 puissance 32
 console.log(tableauB.length); // 4294967295
-
+``` -

Vous pouvez modifier la propriété length d'un tableau à loisir pour le tronquer. Quand vous étendez un tableau en modifiant la valeur de sa propriété length, le nombre d'éléments réellement présents dans ce tableau n'augmente pas : par exemple, si vous affectez la valeur 3 à la propriété length d'un tableau alors qu'elle vaut 2, le tableau contiendra toujours seulement 2 éléments. La troisième « case » ne sera pas itérable. De ce fait, la propriété length d'un tableau ne renseigne en rien sur le nombre de valeurs définies dans le tableau. Voir aussi la relation entre longueur et propriétés numériques.

+Vous pouvez modifier la propriété `length` d'un tableau à loisir pour le tronquer. Quand vous étendez un tableau en modifiant la valeur de sa propriété `length`, le nombre d'éléments réellement présents dans ce tableau n'augmente pas : par exemple, si vous affectez la valeur 3 à la propriété `length` d'un tableau alors qu'elle vaut 2, le tableau contiendra toujours seulement 2 éléments. La troisième « case » ne sera pas itérable. De ce fait, la propriété `length` d'un tableau ne renseigne en rien sur le nombre de valeurs définies dans le tableau. Voir aussi [la relation entre longueur et propriétés numériques](/fr/docs/Web/JavaScript/Reference/Objets_globaux/Array#Relation_entre_length_et_les_propri.C3.A9t.C3.A9s_num.C3.A9riques). -
const arr = [1, 2, 3];
+```js
+const arr = [1, 2, 3];
 console.table(arr);
 // [1, 2]
 
 arr.length = 5; // On définit une longueur à 5
 console.table(arr);
-// [1, 2, <3 éléments vides>]
+// [1, 2, <3 éléments vides>]
 
-arr.forEach(element => console.log(element));
+arr.forEach(element => console.log(element));
 // 1
 // 2
-
+``` -

{{js_property_attributes(1,0,0)}}

+{{js_property_attributes(1,0,0)}} -

Exemples

+## Exemples -

Renvoyer la longueur d'un tableau

+### Renvoyer la longueur d'un tableau -
var items = ["chaise", "bureau", "table", "sac"];
+```js
+var items = ["chaise", "bureau", "table", "sac"];
 items.length; // 4
-
+``` -

Parcourir un tableau

+### Parcourir un tableau -

Dans l'exemple suivant, on itère sur le tableau nombres en utilisant la propriété length afin de connaître son nombre d'élément. La valeur de chaque élément est ensuite multipliée par deux :

+Dans l'exemple suivant, on itère sur le tableau `nombres` en utilisant la propriété `length` afin de connaître son nombre d'élément. La valeur de chaque élément est ensuite multipliée par deux : -
var nombres = [1,2,3,4,5];
+```js
+var nombres = [1,2,3,4,5];
 
-for (var i = 0; i < nombres.length; i++) {
+for (var i = 0; i < nombres.length; i++) {
   nombres[i] *= 2;
 }
 // nombres vaut maintenant [2,4,6,8,10];
-
+``` -

Tronquer un tableau

+### Tronquer un tableau -

L'exemple suivant raccourcit le tableau etatsUS à 50 si sa longueur actuelle est supérieure à 50.

+L'exemple suivant raccourcit le tableau `etatsUS` à 50 si sa longueur actuelle est supérieure à 50. -
if (etatsUS.length > 50) {
+```js
+if (etatsUS.length > 50) {
    etatsUS.length = 50;
-}
- -

Specifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpécificationÉtatCommentaires
{{SpecName('ES1')}}{{Spec2('ES1')}}Définition initiale.
{{SpecName('ES5.1', '#sec-15.4.5.2', 'Array.length')}}{{Spec2('ES5.1')}}
{{SpecName('ES6', '#sec-properties-of-array-instances-length', 'Array.length')}}{{Spec2('ES6')}}
{{SpecName('ESDraft', '#sec-properties-of-array-instances-length', 'Array.length')}}{{Spec2('ESDraft')}}
- -

Compatibilité des navigateurs

- -

{{Compat("javascript.builtins.Array.length")}}

- -

Voir aussi

- - +} +``` + +## Specifications + +| Spécification | État | Commentaires | +| ---------------------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------- | +| {{SpecName('ES1')}} | {{Spec2('ES1')}} | Définition initiale. | +| {{SpecName('ES5.1', '#sec-15.4.5.2', 'Array.length')}} | {{Spec2('ES5.1')}} | | +| {{SpecName('ES6', '#sec-properties-of-array-instances-length', 'Array.length')}} | {{Spec2('ES6')}} | | +| {{SpecName('ESDraft', '#sec-properties-of-array-instances-length', 'Array.length')}} | {{Spec2('ESDraft')}} | | + +## Compatibilité des navigateurs + +{{Compat("javascript.builtins.Array.length")}} + +## Voir aussi + +- {{jsxref("Array")}} -- cgit v1.2.3-54-g00ecf