transpose

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

Der Wert in Zeile i, Spalte j der Eingabe steht im Ergebnis in Zeile j, Spalte i. Es entsteht eine neue Matrix; die Eingabe bleibt unverändert.

Die Eingabe muss eine Matrix mit gleich langen Zeilen sein — die Regel, die isConsistent2DArray formuliert — denn eine ungleichmäßige Matrix hat keine Transponierte. Alles andere wirft einen einfachen Error.

In einer Tabelle ist das die Umrechnung zwischen den beiden Formen eines Bereichs: eine Spalte, gelesen als je eine Zeile pro Zelle, und eine einzelne Zeile mit denselben Werten.

Parameter

Parameter	Typ	Beschreibung
`arr`	`unknown`	Die zu transponierende Matrix. Bleibt unverändert.

Rückgabewert

Array<Array<unknown>> — eine neue Matrix mit vertauschten Zeilen und Spalten. Die Elementtypen bleiben erhalten.

Ausnahmen

Ausnahme	Bedingung
`Error`	die Eingabe ist keine Matrix oder ihre Zeilen sind unterschiedlich lang.

Beispiele

Zeilen werden zu Spalten

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

Eine Liste in eine Spalte schreiben

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);
}

Ungültige Eingabe

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

Siehe auch

isConsistent2DArray — die Form, die transpose verlangt.
chunk — formt ein flaches Array zu Zeilen um.
Basis-Werkzeuge

Quellcode

src/lang/array/transpose.ts

23 September 2026

Diese Dokumentation wurde mit KI (Claude) aus dem Quellcode der Bibliothek erzeugt.