jQuery.merge()

Description: Merge the contents of two arrays together into the first array.

The $.merge() operation forms an array that contains all elements from the two arrays. The orders of items in the arrays are preserved, with items from the second array appended. The $.merge() function is destructive. It alters the first parameter to add the items from the second.

If you need the original first array, make a copy of it before calling $.merge(). Fortunately, $.merge() itself can be used for this duplication:

var newArray = $.merge([], oldArray);

This shortcut creates a new, empty array and merges the contents of oldArray into it, effectively cloning the array.

Prior to jQuery 1.4, the arguments should be true Javascript Array objects; use $.makeArray if they are not.

Examples

Example 1

$.merge( [0,1,2], [2,3,4] )

Example 2

$.merge( [3,2,1], [4,3,2] )

Example 3

var first = ['a','b','c'];
var second = ['d','e','f'];
$.merge( $.merge([],first), second);