nonConsistent2DArray

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

nonConsistent2DArray(value) est la même vérification que !isConsistent2DArray(value), écrite pour qu'une clause de garde se lise dans le bon sens — voir Conventions de validation.

Comme non2DArray, la fonction est faite pour sa réponse booléenne : après le test, TypeScript ne rend pas un type de matrice exploitable. C'est requireConsistent2DArray qui valide et renvoie la matrice.

Elle renvoie true dans deux situations distinctes : une matrice dont les lignes diffèrent en longueur, et une valeur qui n'est pas une matrice du tout. Le résultat seul ne permet pas de les distinguer ; utilisez non2DArray quand la différence compte.

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 de même longueur ; sinon false.

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

Exemples

Les deux cas d'échec

nonConsistent2DArray([[1, 2], [3]]); // => true — ragged
nonConsistent2DArray([1, 2]); // => true — not 2D
nonConsistent2DArray([
  [1, 2],
  [3, 4]
]); // => false

Distinguer les deux cas

/**
 * Tells the two failure cases apart: not a matrix at all, versus a matrix
 * whose rows differ in length.
 */
export function describeShape(rows: unknown): string {
  if (non2DArray(rows)) {
    return "not a matrix";
  }

  if (nonConsistent2DArray(rows)) {
    return "a matrix, but the rows differ in length";
  }

  return "ready for setValues";
}

function describeShape(rows) {
  if (non2DArray(rows)) {
    return "not a matrix";
  }
  if (nonConsistent2DArray(rows)) {
    return "a matrix, but the rows differ in length";
  }
  return "ready for setValues";
}

Voir aussi

isConsistent2DArray — la forme positive.
non2DArray — ne rejette que les non-matrices.
requireConsistent2DArray — lève et nomme la ligne fautive.
Utilitaires de base

Code source

src/lang/array/nonConsistent2DArray.ts

23 September 2026

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