concat メソッド (Array オブジェクト)

2 つ以上の配列を連結した新しい配列を返します。

array1.concat([item1[, item2[, . . . [, itemN]]]]) 

引数

• array1
  必ず指定します。他のすべての配列と連結する Array オブジェクトの名前を指定します。
• item1,. . ., itemN
  省略可能です。array1 の後に追加する項目を指定します。

解説

concat メソッドは、array1 と他の項目が連結された配列が格納された Array オブジェクトを返します。

項目 (item1 _ itemN) は、左から右の順で追加されます。項目の 1 つが配列である場合は、array1 の最後に追加されます。項目が配列以外である場合は、配列の最後に 1 つの配列要素として追加されます。

元の配列の要素は、次のように結果の配列にコピーされます。

• 連結される配列から新しい配列にオブジェクト参照をコピーした場合、オブジェクト参照によって指定されるオブジェクトは変わりません。新しい配列と元の配列のいずれかが変更されると、その変更は他方にも反映されます。
• 新しい配列に数値または文字列の値が連結された場合は、値のみがコピーされます。一方の配列が変更された場合でも、その変更は他方には反映されません。

使用例

次のコードは、concat メソッドの配列内での使用例です。

function ConcatArrayDemo(){
   var a, b, c, d;
   a = new Array(1,2,3);
   b = "JScript");
   c = new Array(42, "VBScript);
   d = a.concat(b, c);
// 配列 [1, 2, 3, "JScript", 42, "VBScript"] を返します。
   return(d);
}

必要条件

バージョン 3

参照

concat メソッド (String オブジェクト) | join メソッド | String オブジェクト

対象: Array オブジェクト