nonConsistent2DArray

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

nonConsistent2DArray(value) — та сама перевірка, що й !isConsistent2DArray(value), записана так, щоб охоронна умова читалася зліва направо — дивіться Домовленості про перевірки.

Як і non2DArray, цю функцію варто використовувати заради логічної відповіді: після перевірки TypeScript не віддає придатний до роботи тип матриці. Перевіряє та повертає матрицю requireConsistent2DArray.

Функція повертає true у двох різних ситуаціях: матриця з рядками різної довжини і значення, яке матрицею взагалі не є. За результатом їх не розрізнити, тож коли різниця важлива, використовуйте non2DArray.

Параметри

Параметр	Тип	Опис
`arr`	`T \\| Array<Array<unknown>>`	Значення, що перевіряється.

Повертає

boolean — true, якщо значення не є непорожнім масивом масивів однакової довжини; інакше false.

У TypeScript усередині гілки значення arr звужується до T.

Приклади

Обидва випадки відмови

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

Як розрізнити ці випадки

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

Дивіться також

isConsistent2DArray — позитивна форма.
non2DArray — відхиляє лише не-матриці.
requireConsistent2DArray — викидає виняток і називає проблемний рядок.
Базові утиліти

Вихідний код

src/lang/array/nonConsistent2DArray.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.