public concat([value:Object]) : Array

パラメータで指定されたエレメントを配列内のエレメントと連結して、新しい配列を作成します。value パラメータで配列が指定されている場合は、配列自体でなく、その配列のエレメントが連結されます。配列 my_array は変更されません。

パラメータ

value:Object (オプション) - 新しい配列内で連結される数値、エレメント、またはストリング。値を渡さない場合には、my_array の複製が作成されます。

戻り値

Array - この配列のエレメントの後にパラメータのエレメントが続く配列。

例

次のコードは、2 つの配列を連結します。

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);
// 配列 [a,b,c,1,2,3] を作成します。

次のコードは、3 つの配列を連結します。

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);
// 配列 [1,3,5,2,4,6,7,8,9] を作成します。

ネストされた配列は、通常の配列と同じように処理されます。次の例で示すとおり、ネストされた配列内のエレメントは、配列 x_array 内で個別のエレメントとして分解されません。

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

// 2 および 3 はネストされた配列内のエレメントです。
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