MACROMEDIA FLASH 8-FLASH LITE 2.X ACTIONSCRIPT LANGUAGE Reference page 253

Concatenates the elements specified in the parameters with the elements in an array and
creates a new array. If the
concatenated, rather than the array itself. The array
Availability: ActionScript 1.0; Flash Lite 2.0
Parameters
[optional] - Numbers, elements, or strings to be concatenated in a new array.
value:Object
If you don't pass any values, a duplicate of
Returns
- An array that contains the elements from this array followed by elements from the
Array
parameters.
Example
The following code concatenates two arrays:
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].
The following code concatenates three arrays:
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].
Nested arrays are not flattened in the same way as normal arrays. The elements in a nested
array are not broken into separate elements in array
example:
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
trace(x_array[4]); // 2, 3
trace(x_array[5]); // 4
parameters specify an array, the elements of that array are
value
my_array
is left unchanged.
my_array
is created.
, as shown in the following
x_array
Array 253