non2DArray

function non2DArray<T>(arr: T | Array<Array<unknown>>): arr is T;

non2DArray(value) est la même vérification que !is2DArray(value). Le préfixe existe pour qu'une clause de garde se lise comme une phrase plutôt que comme une négation — voir Conventions de validation.

Un tableau vide compte comme « non bidimensionnel », puisque is2DArray exige au moins une ligne.

Une réserve sur les types : la garde est déclarée comme prédicat de type, mais elle n'affine utilement que si le type de la valeur mentionne déjà unknown[][]. Dans la branche où la valeur est une matrice, TypeScript en reste à never plutôt qu'à un type de matrice ; utilisez alors is2DArray ou require2DArray. Comme simple réponse booléenne, non2DArray est toujours exact.

Paramètres

Paramètre	Type	Description
`arr`	`T \\| Array<Array<unknown>>`	La valeur à vérifier.

Valeur de retour

boolean — true si la valeur n'est pas un tableau non vide de tableaux ; sinon false.

En TypeScript, le garde restreint arr à T dans la branche.

Exemples

Ce qui compte comme non bidimensionnel

non2DArray([1, 2]); // => true — flat
non2DArray([]); // => true — no rows
non2DArray("abc"); // => true
non2DArray([[1], [2]]); // => false

Indiquer pourquoi une valeur a été rejetée

/**
 * Validates the shape of a value before it reaches `setValues`, and returns
 * the reason it was rejected rather than throwing.
 */
export function validateShape(rows: unknown): string | null {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }

  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }

  return null;
}

function validateShape(rows) {
  if (non2DArray(rows)) {
    return "Expected a matrix: a non-empty array of rows.";
  }
  if (nonConsistent2DArray(rows)) {
    return "Every row must have the same number of columns.";
  }
  return null;
}

Voir aussi

is2DArray — la forme positive.
nonConsistent2DArray — rejette en plus une matrice irrégulière.
require2DArray — lève une exception au lieu de répondre.
Utilitaires de base

Code source

src/lang/array/non2DArray.ts

23 September 2026

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