Flash Lite 2

Guide de référence du langage ActionScript Flash Lite 2.x > Classes ActionScript > Array > concat (méthode Array.concat)

concat (méthode Array.concat)

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 celui-ci sont concaténés, au lieu du tableau lui-même. Le tableau my_array demeure inchangé.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

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.

Valeur renvoyée

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);
// Crée le tableau [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);
// Crée le tableau [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 et 3 sont des éléments dans un tableau imbriqué.
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
trace(x_array[4]); // 2, 3 
trace(x_array[5]); // 4