A-C > Array (objet)

Array (objet)

L'objet Array vous permet d'accéder à des tableaux et de les manipuler. Un tableau est un objet dont les propriétés sont identifiées par un nombre représentant leur position dans le tableau. Ce nombre est appelé index. Tous les tableaux sont basés sur zéro, ce qui signifie que le premier élément du tableau est [0], le second élément est [1], et ainsi de suite. Dans l'exemple suivant, monTableau contient les mois de l'année.

monTableau[0] = "janvier"
monTableau[1] = "février"
monTableau[2] = "mars"
monTableau[3] = "avril"

Pour créer un objet Array, utilisez le constructeur new Array ou l'opérateur d'accès tableau ([]). Pour accéder aux éléments d'un tableau, utilisez l'opérateur d'accès tableau ([ ]).

Dans Flash MX, l'objet Array est devenu un objet natif. Vous pourrez donc constater d'importantes améliorations des performances.

 
Méthodes de l'objet Array

Méthode	Description
Array.concat	Concatène les paramètres et les renvoie sous forme de nouveau tableau.
Array.join	Joint tous les éléments d'un tableau dans une chaîne.
Array.pop	Supprime le dernier élément d'un tableau et renvoie sa valeur.
Array.push	Ajoute un ou plusieurs éléments à la fin d'un tableau et renvoie la nouvelle longueur du tableau.
Array.reverse	Inverse la direction d'un tableau.
Array.shift	Supprime le premier élément d'un tableau et renvoie sa valeur.
Array.slice	Extrait une section d'un tableau et la renvoie sous forme de nouveau tableau.
Array.sort	Trie un tableau en place.
Array.sortOn	Trie un tableau en fonction d'un champ du tableau.
Array.splice	Ajoute et/ou retire des éléments d'un tableau.
Array.toString	Renvoie une valeur de chaîne représentant les éléments dans l'objet Array.
Array.unshift	Ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.

 
Propriétés de l'objet Array

Propriété	Description
Array.length	Renvoie la longueur du tableau.

 
Constructeur de l'objet Array

Disponibilité

Flash Player 5.

Usage

new Array()
new Array(longueur)
new Array(élément0, élément1, élément2,...élémentN)

Paramètres

longueur Un entier spécifiant le nombre d'éléments dans un tableau. Dans le cas d'éléments non contigus, le paramètre longueur spécifie le numéro d'index du dernier élément du tableau plus 1.

élément0...élémentN Une liste de deux ou plusieurs valeurs arbitraires. Les valeurs peuvent être des nombres, des chaînes, des objets ou d'autres tableaux. Le premier élément d'un tableau a toujours un index ou une position de 0.

Renvoie

Rien.

Description

Constructeur ; permet de créer un tableau. Vous pouvez utiliser le constructeur pour créer différents types de tableaux : un tableau vide, un tableau avec une longueur spécifique, mais dont les éléments n'ont pas de valeur, ou un tableau dont les éléments ont des valeurs spécifiques.

Usage 1. Si vous ne spécifiez aucun paramètre, un tableau de longueur zéro est créé.

Usage 2. Si vous spécifiez seulement une longueur, un tableau est créé avec le nombre longueur d'éléments sans valeur.

Usage 3. Si vous utilisez les paramètres élément pour spécifier des valeurs, le tableau est créé avec des valeurs spécifiques.

Exemple

Usage 1. L'exemple suivant crée un nouvel objet Array avec une longueur initiale de 0.

monTableau = new Array();

Usage 3. L'exemple suivant crée le nouvel objet Array go_gos, avec une longueur initiale de 5.

go_gos = new Array("Belinda", "Gina", "Kathy", "Charlotte", "Jane");
trace(go_gos.join(" + "));

Les éléments initiaux du tableau go_gos sont identifiés comme suit :

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

Le code suivant ajoute un sixième élément au tableau go-gos et change le premier élément :

go_gos[5] = "Donna";
go_gos[1] = "Nina"
trace(go_gos.join(" + "));

Voir aussi

Array.length, [] (accès tableau)