transpose

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

La valeur en ligne i, colonne j de l'entrée se retrouve en ligne j, colonne i du résultat. Une nouvelle matrice est construite ; l'entrée n'est pas modifiée.

L'entrée doit être une matrice à lignes de même longueur — la règle qu'énonce isConsistent2DArray — puisqu'une matrice irrégulière n'a pas de transposée. Tout le reste lève un Error ordinaire.

Dans une feuille, c'est la conversion entre les deux formes d'une même plage : une colonne lue à raison d'une ligne par cellule, et une seule ligne portant les mêmes valeurs.

Paramètres

Paramètre	Type	Description
`arr`	`unknown`	La matrice à transposer. Elle n'est pas modifiée.

Valeur de retour

Array<Array<unknown>> — une nouvelle matrice aux lignes et colonnes échangées. Les types des éléments sont conservés.

Exceptions

Exception	Condition
`Error`	l'entrée n'est pas une matrice, ou ses lignes diffèrent en longueur.

Exemples

Les lignes deviennent des colonnes

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

Écrire une liste dans une colonne

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

Entrée invalide

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

Voir aussi

isConsistent2DArray — la forme qu'exige transpose.
chunk — remet un tableau plat en lignes.
Utilitaires de base

Code source

src/lang/array/transpose.ts

23 September 2026

Cette documentation a été générée par une IA (Claude) à partir du code source de la bibliothèque.