Spec-Zone.ru › jQuery

jQuery.merge()

jQuery.merge( first, second )Возвращает: Массив

Описание: Объединяет содержимое двух массивов в первый массив.

  • версия добавлена: 1.0jQuery.merge( first, second )

    • first
      Тип: Массивоподобный объект
      Первый массивоподобный объект для объединения, элементы second добавляются.
    • second
      Тип: Массивоподобный объект
      Второй массивоподобный объект для объединения в первый, не изменяется.

Операция $.merge() формирует массив, содержащий все элементы из двух массивов. Порядок элементов в массивах сохраняется, элементы из второго массива добавляются в конец. Функция $.merge() является разрушающей. Она изменяет свойства length и числовой индекс первого объекта, чтобы включить элементы из второго.

Если вам нужен исходный первый массив, сделайте его копию перед вызовом $.merge(). К счастью, $.merge() сама может быть использована для этой дубликации:

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

Этот сокращенный вариант создает новый пустой массив и объединяет содержимое oldArray в него, эффективно клонируя массив.

До jQuery 1.4 аргументы должны быть истинными JavaScript-массивами; используйте $.makeArray если это не так.

Примеры:

Объединяет два массива, изменяя первый аргумент.

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

Результат:

[ 0, 1, 2, 2, 3, 4 ]

Объединяет два массива, изменяя первый аргумент.

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

Результат:

[ 3, 2, 1, 4, 3, 2 ]

Объединяет два массива, но использует копию, поэтому оригинал не изменяется.

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

Результат:

[ "a", "b", "c", "d", "e", "f" ]

© The jQuery Foundation and other contributors
Licensed under the MIT License.
https://api.jquery.com/jQuery.merge

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API