Sha256: fcc438e50c00c9e865d9c1777627d3fdc1e13a4078c996fb4b04e67e462648c8
Contents?: true
Size: 1.28 KB
Versions: 33
Compression:
Stored size: 1.28 KB
Contents
import type {IsEqual, Subtract} from './internal';
type Recursive<T> = Array<Recursive<T>>;
/**
Creates a type that represents a multidimensional array of the given type and dimension.
Use-cases:
- Return a n-dimensional array from functions.
- Declare a n-dimensional array by defining its dimensions rather than declaring `[]` repetitively.
- Infer the dimensions of a n-dimensional array automatically from function arguments.
- Avoid the need to know in advance the dimensions of a n-dimensional array allowing them to be dynamic.
@example
```
import type {MultidimensionalArray} from 'type-fest';
function emptyMatrix<T extends number>(dimensions: T): MultidimensionalArray<unknown, T> {
const matrix: unknown[] = [];
let subMatrix = matrix;
for (let dimension = 1; dimension < dimensions; ++dimension) {
console.log(`Initializing dimension #${dimension}`);
subMatrix[0] = [];
subMatrix = subMatrix[0] as unknown[];
}
return matrix as MultidimensionalArray<unknown, T>;
}
const matrix = emptyMatrix(3);
matrix[0][0][0] = 42;
```
@category Array
*/
export type MultidimensionalArray<Element, Dimensions extends number> = number extends Dimensions
? Recursive<Element>
: IsEqual<Dimensions, 0> extends true
? Element
: Array<MultidimensionalArray<Element, Subtract<Dimensions, 1>>>;
Version data entries
33 entries across 33 versions & 1 rubygems