Array.concat()

Disponibilidad

Flash Player 5.

Sintaxis

my_array.concat( [ value0,value1,...valueN ])

Parámetros

value0,...valueN Números, elementos o cadenas que se van a concatenar en una nueva matriz. Si no se pasa ningún valor, se creará un duplicado de my_array.

Valor devuelto

Ninguno.

Descripción

Método; concatena los elementos especificados en los parámetros con los elementos de my_array y crea una matriz nueva. Si los parámetros value especifican una matriz, se concatenan los elementos de esa matriz en lugar de la propia matriz. La matriz my_array se deja intacta.

Ejemplo

En el código siguiente se concatenan dos matrices:

alpha_array = new Array("a","b","c");
numeric_array = new Array(1,2,3);
alphaNumeric_array=alpha_array.concat(numeric_array); 
trace(alphaNumeric_array);
// crea la matriz ["a","b","c",1,2,3]

En el código siguiente se concatenan tres matrices:

num1_array = [1,3,5];
num2_array = [2,4,6];
num3_array = [7,8,9];
nums_array=num1_array.concat(num2_array,num3_array) 
trace(nums_array);
// crea la matriz [1,3,5,2,4,6,7,8,9]

Las matrices anidadas no se despliegan del mismo modo que las matrices normales. Los elementos de una matriz anidada no se desglosan en elementos independientes de una matriz x_array, como se muestra en el ejemplo siguiente.

a_array = new Array ("a","b","c");

// 2 y 3 son elementos de una matriz anidada
n_array = new Array(1, [2, 3], 4); 

x_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