concat Method (Array)


function concat([item1 : { Object \| Array } [, ... [, itemN : { Object \| Array }]]]]) : Array

item1, item2, ..., itemN: Optional. Additional items to add to the end of the current array.

The concat method returns an Array object containing the concatenation of the current array and any other supplied items.

The items to be added (item1 ... itemN) to the array are added, in order, from left to right. If one of the items is an array, its contents are added to the end of the current array. If the item is anything other than an array, it is added to the end of the array as a single array element.

Elements of source arrays are copied to the resulting array as follows:

For an object reference copied from any of the arrays being concatenated to the new array, the object reference continues to point to the same object. A change in either the new array or the original array will result in a change to the other.
For a numeric or string value being concatenated to the new array, only the value is copied. Changes in a value in one array do not affect the value in the other.

The following example illustrates the use of the concat method when used with an array:

В	Copy Code
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); //Returns the array [1, 2, 3, "JScript", 42, "VBScript"] return(d); }

В

Copy Code

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);
   //Returns the array [1, 2, 3, "JScript", 42, "VBScript"]
   return(d);
}

Version 3

Applies To:

Array Object

Reference

concat Method (String)
join Method
String Object

Arguments

Remarks

Example

Requirements

Applies To:

See Also

Reference