Flash Lite 2

Guide de référence du langage ActionScript Flash Lite 2.x > Eléments du langage ActionScript > Fonctions globales > Fonction Array

Fonction Array

Array(): Array Array(numElements:Number): Array Array( [element0:Object [, element1, element2, ...elementN] ]) : Array

Crée un nouveau tableau de longueur zéro ou supérieure, ou un tableau contenant la liste des éléments spécifiés, probablement de types de données différents.

Permet de créer l'un des tableaux suivants :

• un tableau vide ;
• un tableau d'une longueur spécifique mais dont les éléments ont des valeurs non définies ;
• un tableau dont les éléments ont des valeurs spécifiques.

L'utilisation de cette fonction revient à créer un tableau avec le constructeur Array (voir « Constructeur pour la classe Array »).

Vous pouvez transmettre un nombre (numElements) ou la liste des éléments contenant un ou plusieurs types différents (element0, element1, ... elementN).

Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés dans la signature sous le type Object.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

numElements [facultatif] - Un entier positif spécifiant le nombre d'éléments contenus dans le tableau. Vous pouvez spécifier numElements ou la liste des éléments, mais pas les deux.

elementN [facultatif] - un ou plusieurs paramètres, element0, element1, ... , elementN, dont les valeurs peuvent être de n'importe quel type. Les paramètres qui peuvent accepter plusieurs types de données sont répertoriés sous le type Object. Vous pouvez spécifier numElements ou la liste des éléments, mais pas les deux.

Valeur renvoyée

Array - Tableau.

Exemple

var myArray:Array = Array();
myArray.push(12);
trace(myArray); // Renvoie 12
myArray[4] = 7;
trace(myArray); // Renvoie 12,undefined,undefined,undefined,7

Utilisation 2 : L'exemple suivant crée un tableau de longueur 4 qui n'inclut aucun élément défini :

var myArray:Array = Array(4);
trace(myArray.length); // Renvoie 4
trace(myArray); // Renvoie undefined,undefined,undefined,undefined

Utilisation 3 : L'exemple suivant crée un tableau incluant trois éléments définis :

var myArray:Array = Array("firstElement", "secondElement", "thirdElement");
trace (myArray); // Renvoie firstElement,secondElement,thirdElement
    // Contrairement au constructeur de classe Array, la fonction Array() 
// n'utilise pas le mot-clé new.

Voir aussi

Array