Flash Lite 2

Flash Lite 2.x ActionScript リファレンスガイド > ActionScript クラス > Array > concat (Array.concat メソッド)

concat (Array.concat メソッド)

public concat([value: Object]) : Array

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

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

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