Google Apps Script: Как объединить массивы?

Google Apps Script: Как объединить массивы?

Введение в объединение массивов в Google Apps Script

Что такое массив в Google Apps Script?

В Google Apps Script, массив – это упорядоченный набор элементов. Элементы могут быть различных типов данных: числа, строки, булевы значения, другие массивы и даже объекты. Массивы являются фундаментальной структурой данных, используемой для хранения и обработки коллекций информации.

Пример:

/**
 * Пример массива в Google Apps Script.
 * @customfunction
 */
function exampleArray() {
  let myArray: any[] = [1, "hello", true, [2, 3]];
  Logger.log(myArray); // Вывод: [1, hello, true, [2.0, 3.0]]
}

Зачем объединять массивы: распространенные сценарии

Объединение массивов часто необходимо для:

Слияния данных из разных источников (например, из разных листов Google Sheets).

Добавления новых элементов к существующим данным.

Создания единого набора данных для последующей обработки или анализа, например, в задачах интернет-маркетинга, таких как объединение данных о рекламных кампаниях из разных платформ.

Формирования отчетов и дашбордов, где требуется агрегировать информацию из различных источников.

Обзор методов объединения массивов

В Google Apps Script существует несколько способов объединить массивы:

concat(): Основной метод для объединения массивов, не изменяющий исходные массивы.

Spread operator (...): Современный и лаконичный синтаксис для объединения массивов, также не изменяющий исходные массивы.

Комбинация с Set: Для объединения массивов с удалением дубликатов.

Метод concat() для объединения массивов

Синтаксис и основные принципы concat()

Метод concat() используется для объединения одного или нескольких массивов в новый массив. Синтаксис:

newArray = array1.concat(array2, array3, ...);

concat() создает новый массив, содержащий элементы всех объединенных массивов. Исходные массивы остаются неизменными.

Объединение двух массивов с помощью concat()

/**
 * Объединение двух массивов с помощью concat().
 * @customfunction
 */
function concatTwoArrays() {
  let array1: number[] = [1, 2, 3];
  let array2: number[] = [4, 5, 6];
  let combinedArray: number[] = array1.concat(array2);
  Logger.log(combinedArray); // Вывод: [1.0, 2.0, 3.0, 4.0, 5.0, 6.0]
  Logger.log(array1);      // Вывод: [1.0, 2.0, 3.0] (исходный массив не изменен)
}

Объединение нескольких массивов с помощью concat()

concat() может принимать несколько массивов в качестве аргументов:

/**
 * Объединение нескольких массивов с помощью concat().
 * @customfunction
 */
function concatMultipleArrays() {
  let array1: string[] = ["a", "b"];
  let array2: string[] = ["c", "d"];
  let array3: string[] = ["e", "f"];
  let combinedArray: string[] = array1.concat(array2, array3);
  Logger.log(combinedArray); // Вывод: [a, b, c, d, e, f]
}

Создание нового массива при объединении (concat() не изменяет исходные массивы)

Важно помнить, что concat() не изменяет исходные массивы. Он всегда возвращает новый массив, содержащий объединенные элементы.

Использование spread operator (…) для объединения массивов

Синтаксис и преимущества spread operator

Spread operator (...) позволяет