Flash Lite 2

Guide de référence du langage ActionScript Flash Lite 2.x > Classes ActionScript > Array > Constructeur Array

Constructeur Array

Permet de créer un tableau. Vous pouvez utiliser le constructeur pour créer différents types de tableaux : un tableau vide, un tableau d'une longueur spécifique mais dont les éléments ont des valeurs non définies, ou un tableau dont les éléments ont des valeurs spécifiques.

Utilisation 1 : si vous ne spécifiez aucun paramètre, un tableau d'une longueur de 0 est créé.

Utilisation 2 : si vous spécifiez uniquement une longueur, un tableau contenant un nombre d'éléments de length est créé. La valeur de chaque élément est définie sur undefined.

Utilisation 3 : Si vous utilisez les paramètres element pour spécifier des valeurs, un tableau est créé avec des valeurs spécifiques.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

value:Object [facultatif] - Soit :

• Un entier spécifiant le nombre d'éléments contenus dans le tableau.
• Une liste de deux valeurs arbitraires au minimum. Les valeurs peuvent être de type Boolean, Number, String, Object ou Array. La valeur de l'index ou de la position du premier élément d'un tableau est toujours 0.

Remarque : Si un seul paramètre numérique est transmis au constructeur Array, il s'agit du paramètre length par défaut ; celui-ci est converti en entier à l'aide de la fonction Integer().

Exemple

Utilisation 1 : L'exemple suivant crée un nouvel objet Array d'une longueur initiale de 0 :

var my_array:Array = new Array(); 
trace(my_array.length); // Renvoie 0.

Utilisation 2 : L'exemple suivant crée un nouvel objet Array d'une longueur initiale de 4 :

var my_array:Array = new Array(4);
trace(my_array.length); // Renvoie 4.
trace(my_array[0]); // Renvoie undefined.
if (my_array[0] == undefined) { // Aucun guillemet autour de undefined.
    trace("undefined is a special value, not a string");
} // Renvoie : undefined is a special value, not a string.

Utilisation 3 : L'exemple suivant crée le nouvel objet Array go_gos_array d'une longueur initiale de 5 :

var go_gos_array:Array = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
trace(go_gos_array.length); // Renvoie 5.
trace(go_gos_array.join(", ")); // Affiche des éléments.

Les éléments initiaux du tableau go_gos_array sont identifiés, comme indiqué dans l'exemple suivant :

go_gos_array[0] = "Belinda";
go_gos_array[1] = "Gina";
go_gos_array[2] = "Kathy";
go_gos_array[3] = "Charlotte";
go_gos_array[4] = "Jane";

Le code suivant ajoute un sixième élément au tableau go_gos_array et modifie le deuxième élément :

go_gos_array[5] = "Donna";
go_gos_array[1] = "Nina"
trace(go_gos_array.join(" + "));
// Renvoie Belinda + Nina + Kathy + Charlotte + Jane + Donna.

Voir aussi

Opérateur d'accès au tableau [], length (propriété Array.length)