nonConsistent2DArray

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

nonConsistent2DArray(value) ist dieselbe Prüfung wie !isConsistent2DArray(value), so geschrieben, dass eine Wächterklausel vorwärts gelesen wird — siehe Konventionen der Prüfungen.

Wie non2DArray ist die Funktion für ihre Ja-Nein-Antwort gedacht: nach der Prüfung gibt TypeScript keinen brauchbaren Matrixtyp zurück. Prüfen und zurückgeben tut requireConsistent2DArray.

Sie meldet true in zwei verschiedenen Fällen: eine Matrix mit unterschiedlich langen Zeilen und ein Wert, der gar keine Matrix ist. Am Ergebnis sind sie nicht zu unterscheiden; wo der Unterschied zählt, nehmen Sie non2DArray.

Parameter

Parameter	Typ	Beschreibung
`arr`	`T \\| Array<Array<unknown>>`	Der zu prüfende Wert.

Rückgabewert

boolean — true, wenn der Wert kein nicht-leeres Array aus gleich langen Arrays ist; sonst false.

In TypeScript verengt die Prüfung arr innerhalb des Zweigs auf T.

Beispiele

Beide Fehlerfälle

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

Die beiden Fälle unterscheiden

/**
 * 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";
}

Siehe auch

isConsistent2DArray — die positive Form.
non2DArray — lehnt nur die Nicht-Matrizen ab.
requireConsistent2DArray — wirft und benennt die betroffene Zeile.
Basis-Werkzeuge

Quellcode

src/lang/array/nonConsistent2DArray.ts

23 September 2026

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