Поделиться через


Метод concat (массив)

Возвращает новый массив, состоящий из сочетания текущего массива с любыми дополнительными элементами.

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

Аргументы

  • item1, item2, ..., itemN
    Необязательный. Дополнительные элементы, которые необходимо добавить в конец текущего массива*.*

Заметки

Метод concat возвращает объект Array, содержащий объединение текущего массива с любыми другими предоставленными элементами.

Элементы, которые требуется добавить к массиву (item1 ... itemN), добавляются последовательно, слева направо. Если одни из элементов является массивом, его содержимое добавляется в конец текущего массива. Если массив не является массивом, он добавляется в конец массива как отдельный элемент.

При копировании элементов исходных массивов в результирующий массив выполняются следующие правила.

  • Если из одного из массивов, объединяемых в новый массив, копируется ссылка на объект, то эта ссылка продолжает указывать на тот же объект. Изменение в новом или исходном массиве приводит к изменению в другом массиве.

  • При добавлении в новый массив строкового или числового значения выполняется только копирование значения. Изменения значения в одном массиве не влияет на значение в другом.

Пример

В следующем примере показано использование метода 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);
   //Returns the array [1, 2, 3, "JScript", 42, "VBScript"]
   return(d);
}

Требования

Версия 3

Применение:

Объект Array

См. также

Ссылки

Метод concat (строка)

Метод join

Объект String