documentation flash array

Vous êtes ici: Les articles techniques » documentation » Eléments du langage ActionScript » Array

Array

Object
     |
     +-Array
 
public dynamic class **Array**
extends Object

La classe Array vous permet d’accéder aux tableaux indexés et de les manipuler. Un tableau indexé est un objet dont les propriétés sont identifiées par un nombre représentant leur position au sein de celui-ci. Ce nombre est appelé index. Tous les tableaux indexés sont basés sur zéro, ce qui signifie que le premier élément du tableau est [0], le deuxième est [1], etc. Pour créer un objet Array, utilisez le constructeur new Array(). Pour accéder aux éléments d’un tableau, utilisez l’opérateur d’accès au tableau ([]).

Vous pouvez stocker divers types de données dans un élément de tableau, y compris les nombres, les chaînes, les objets et même d’autres tableaux. Vous pouvez créer un tableau multidimensionnel en concevant un tableau indexé et en affectant à chacun de ses éléments un tableau indexé différent. Ce type de tableau est considéré comme étant miltidimensionnel car il peut être utilisé pour représenter des données dans un tableau.

L’affectation au tableau s’effectue par référence plutôt que par valeur : lorsque vous affectez une variable de tableau à une autre variable de tableau, elles renvoient toutes deux au même tableau :

var oneArray:Array = new Array("a", "b", "c");
var twoArray:Array = oneArray; // Both array variables refer to the same array.
twoArray[0] = "z"; 
trace(oneArray); // Output: z,b,c.

La classe Array ne doit pas être utilisée pour créer des tableaux associatifs car il s’agit de structures de données différentes qui contiennent des éléments nommés au lieu d’éléments numérotés. Il est recommandé d’utiliser la classe Object pour créer des tableaux associatifs (également appelés hachages). Bien que ActionScript vous permette de créer des tableaux associatifs à l’aide de la classe Array, vous ne pouvez pas utiliser les méthodes ou les propriétés de cette dernière. Sous sa forme de base, un tableau associatif est une occurrence de la classe Object et chaque paire clé/valeur est représentée par une propriété et sa valeur. Vous pouvez également déclarer un tableau associatif à l’aide du type de données Object pour la raison suivante : cela vous permet d’utiliser ensuite un littéral d’objet pour alimenter votre tableau associatif (uniquement au moment de la déclaration). L’exemple suivant crée un tableau associatif à l’aide d’un littéral d’objet, accède aux éléments à l’aide de l’opérateur point et d’accès au tableau, puis ajoute une nouvelle paire clé/valeur en créant une nouvelle propriété :

var myAssocArray:Object = {fname:"John", lname:"Public"};
trace(myAssocArray.fname); // Output: John
trace(myAssocArray["lname"]); // Output: Public
myAssocArray.initial = "Q";
trace(myAssocArray.initial); // Output: Q

Disponibilité : ActionScript 1.0 ; Flash Player 5

Voir également

Exemple

Dans l’exemple suivant, my_array contient quatre mois de l’année :

var my_array:Array = new Array();
my_array[0] = "January";
my_array[1] = "February";
my_array[2] = "March";
my_array[3] = "April";

Résumé des propriétés

Modificateurs Propriété Description
static CASEINSENSITIVE:Number Dans les méthodes de tri, cette constante spécifie le tri non sensible à la casse.
static DESCENDING:Number Dans les méthodes de tri, cette constante spécifie l’ordre de tri décroissant.
length:Number Un entier non négatif spécifiant le nombre d’éléments contenus dans le tableau.
static NUMERIC:Number Dans les méthodes de tri, cette constante spécifie le tri numérique (au lieu de la chaîne de caractères).
static RETURNINDEXEDARRAY:Number Spécifie qu’un tri renvoie un tableau indexé résultant de l’appel de la méthode sort() ou sortOn().
static UNIQUESORT:Number Dans les méthodes de tri, cette constante spécifie l’unique exigence de tri.

Propriétés héritées de la classe Object

Résumé des constructeurs

Signature Description
Array([value:Object]) Permet de créer un tableau.

Résumé de la méthode

Modificateurs Signature Description
concat([value:Object]) : Array Concatène les éléments spécifiés dans les paramètres avec ceux contenus dans un tableau et crée un nouveau tableau.
join([delimiter:String]) : String Convertit les éléments d’un tableau en chaînes, insère le séparateur spécifié entre les éléments, les concatène, puis renvoie la chaîne obtenue.
pop() : Object Supprime le dernier élément d’un tableau et renvoie la valeur de cet élément.
push(value:Object) : Number Ajoute un ou plusieurs éléments à la fin d’un tableau et renvoie la nouvelle longueur du tableau.
reverse() : Void Inverse le tableau.
shift() : Object Supprime le premier élément d’un tableau et renvoie cet élément.
slice([startIndex:Number], [endIndex:Number]) : Array Renvoie un nouveau tableau constitué d’un éventail d’éléments issus du tableau original, sans modifier ce dernier.
sort([compareFunction:Object], [options:Number]) : Array Trie les éléments d’un tableau.
sortOn(fieldName:Object, [options:Object]) : Array Trie les éléments d’un tableau selon un ou plusieurs champs du tableau.
splice(startIndex:Number, [deleteCount:Number], [value:Object]) : Array Ajoute et supprime des éléments dans un tableau.
toString() : String Renvoie une valeur de chaîne représentant les éléments dans l’objet Array spécifié.
unshift(value:Object) : Number Ajoute un ou plusieurs éléments au début d’un tableau et renvoie la nouvelle longueur du tableau.

Méthodes héritées de la classe Object




veille
inscrits inscrits ! Compensation à la rédaction
  • Inscription au wiki
  • Connexion

vod