# Array.concat()

#### Availability

Flash Player 5.

#### Usage

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

#### Parameters

`value0,...valueN` Numbers, elements, or strings to be concatenated in a new array.

#### Returns

Nothing.

#### Description

Method; concatenates the elements specified in the parameters, if any, with the elements in `my_array`, and creates a new array. If the `value` parameters specify an array, the elements of that array are concatenated, rather than the array itself. The array `my_array` is left unchanged.

#### Example

The following code concatenates two arrays.

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

The following code concatenates three arrays.

    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);
    // creates array [1,3,5,2,4,6,7,8,9]

Nested arrays are not flattened in the same way normal arrays are. The elements in a nested array are not broken into separate elements in array `x_array`, as in the following example.

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

    // 2 and 3 are elements in a nested array
    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