Guide de reference du langage ActionScript 2.0 - PowWeb

concat (méthode Array.concat)
public 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. Si les paramètres value spécifient un tableau, les éléments de celuici
sont concaténés, au lieu du tableau lui-même. Le tableau my_array demeure inchangé.
Disponibilité : ActionScript 1.0 ; Flash Player 5
Paramètres
value:Object [facultatif] - Nombres, éléments ou chaînes à concaténer dans un nouveau
tableau. Si vous ne transmettez aucune valeur, une duplication de my_array est créée.
Renvoie
Array - Un tableau qui contient les éléments de ce tableau suivi des éléments des paramètres.
Exemple
Le code suivant concatène deux tableaux :
var alpha_array:Array = new Array("a","b","c");
var numeric_array:Array = new Array(1,2,3);
var alphaNumeric_array:Array =alpha_array.concat(numeric_array);
trace(alphaNumeric_array);
// Creates array [a,b,c,1,2,3].
Le code suivant concatène trois tableaux :
var num1_array:Array = [1,3,5];
var num2_array:Array = [2,4,6];
var num3_array:Array = [7,8,9];
var nums_array:Array=num1_array.concat(num2_array,num3_array)
trace(nums_array);
// Creates array [1,3,5,2,4,6,7,8,9].
Les tableaux incorporés ne sont pas aplatis de la même manière que les tableaux normaux. Les
éléments d'un tableau incorporé ne sont pas séparés en éléments distincts dans le tableau
x_array, comme indiqué dans l'exemple suivant :
var a_array:Array = new Array ("a","b","c");
// 2 and 3 are elements in a nested array.
var n_array:Array = new Array(1, [2, 3], 4);
var x_array:Array = a_array.concat(n_array);
trace(x_array[0]); // a
trace(x_array[1]); // b
trace(x_array[2]); // c
trace(x_array[3]); // 1
Array 255