transpose

function transpose(arr: unknown): Array<Array<unknown>>;

Значення з рядка i, стовпця j вхідної матриці опиняється в рядку j, стовпці i результату. Будується нова матриця; вихідна не змінюється.

На вході потрібна матриця з однаковою довжиною рядків — правило, яке формулює isConsistent2DArray, — бо в нерівної матриці транспонування не існує. Усе інше призводить до звичайного Error.

У таблиці це перетворення між двома формами одного діапазону: стовпець, прочитаний як по одному рядку на комірку, і один рядок із тими самими значеннями.

Параметри

Параметр	Тип	Опис
`arr`	`unknown`	Матриця для транспонування. Не змінюється.

Повертає

Array<Array<unknown>> — нова матриця з переставленими рядками та стовпцями. Типи елементів зберігаються.

Винятки

Виняток	Умова
`Error`	вхідне значення не матриця або її рядки різної довжини.

Приклади

Рядки стають стовпцями

transpose([
  [1, 2, 3],
  [4, 5, 6]
]);
// => [
//   [1, 4],
//   [2, 5],
//   [3, 6]
// ]

Запис списку в стовпець

setValues wants one row per cell to fill a column, and a flat list is not that shape.

/**
 * Writes a flat list down a column. `setValues` wants one row per cell, which
 * is the transpose of a single row.
 */
export function writeColumn(sheet: GoogleAppsScript.Spreadsheet.Sheet, values: string[]): void {
  const column = transpose([values]);

  sheet.getRange(1, 1, column.length, 1).setValues(column);
}

function writeColumn(sheet, values) {
  const column = transpose([values]);
  sheet.getRange(1, 1, column.length, 1).setValues(column);
}

Некоректний вхід

transpose([1, 2, 3]); // throws Error: Input must be a 2D array.
transpose([[1, 2], [3]]); // throws Error: Input must be a 2D array.

Дивіться також

isConsistent2DArray — форма, якої вимагає transpose.
chunk — перетворює плоский масив на рядки.
Базові утиліти

Вихідний код

src/lang/array/transpose.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.