A-C > Array.concat

Array.concat

Disponibilité

Flash Player 5.

Usage

monTableau.concat(valeur0,valeur1,...valeurN)

Paramètres

valeur0,...valeurN Nombres, éléments ou chaînes devant être concaténés dans un nouveau tableau.

Renvoie

Rien.

Description

Méthode ; concatène les éléments spécifiés dans les paramètres, s'il y en a, avec les éléments de monTableau et crée un nouveau tableau. Si les paramètres valeur spécifient un tableau, ce sont les éléments de ce tableau qui sont concaténés et non le tableau même. Le tableau monTableau reste inchangé.

Exemple

Le code suivant concatène deux tableaux.

alpha = new Array("a","b","c");
numérique = new Array(1,2,3);
alphaNumérique=alpha.concat(numérique); 
trace(alphaNumérique);
// crée le tableau ["a","b","c",1,2,3]

Le code suivant concatène trois tableaux.

num1=[1,3,5];
num2=[2,4,6];
num3=[7,8,9];
nums=num1.concat(num2,num3) 
trace(nums);
// crée le tableau [1,3,5,2,4,6,7,8,9]

Les tableaux imbriqués ne sont pas aplatis de la même façon que les tableaux normaux. Les éléments d'un tableau imbriqué ne sont pas divisés en éléments séparés dans le tableau x, comme dans l'exemple suivant.

a = new Array ("a","b","c");
n = new Array(1, [2, 3], 4); 
// 2 et 3 sont des éléments d'un tableau imbriqué
x = a.concat(n);
x[0] = "a"
x[1] = "b"
x[2] = "c"
x[3] = 1
x[4] = 2, 3
x[5] = 4