Availability
JavaScript 1.2; JScript 3.0; ECMAScript v3
Synopsis
array.concat(value, ...)
Arguments
value, ...
Any number of values to be concatenated with
array.
Returns
A new array, which is formed by concatenating each of the specified
arguments to array.
Description
concat( ) creates and returns a new array that is
the result of concatenating each of its arguments to
array. It does not modify
array. If any of the arguments to
concat( ) is itself an array, the elements of that
array are concatenated, rather than the array itself.
Example
var a = [1,2,3];
a.concat(4, 5) // Returns [1,2,3,4,5]
a.concat([4,5]); // Returns [1,2,3,4,5]
a.concat([4,5],[6,7]) // Returns [1,2,3,4,5,6,7]
a.concat(4, [5,[6,7]]) // Returns [1,2,3,4,5,[6,7]
See Also
Array.join( ), Array.push( ), Array.splice( )