Sha256: d0f07efa072420758194c452edb3f04f8eabc01cd4b3884a23e7274d4e2a7b69

Contents?: true

Size: 1.44 KB

Versions: 33

Compression:

Stored size: 1.44 KB

Contents

import type {IsEqual, Subtract} from './internal';

type Recursive<T> = ReadonlyArray<Recursive<T>>;

/**
Creates a type that represents a multidimensional readonly array that 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 {MultidimensionalReadonlyArray} from 'type-fest';

function emptyMatrix<T extends number>(dimensions: T): MultidimensionalReadonlyArray<unknown, T> {
	const matrix: unknown[] = [];

	let subMatrix = matrix;
	for (let dimension = 1; dimension < dimensions; ++dimension) {
		console.log(`Initializing dimension #${dimension}`);

		subMatrix[0] = [];
		if (dimension < dimensions - 1) {
			subMatrix = subMatrix[0] as unknown[];
		} else {
			subMatrix[0] = 42;
		}
	}

	return matrix as MultidimensionalReadonlyArray<unknown, T>;
}

const matrix = emptyMatrix(3);

const answer = matrix[0][0][0]; // 42
```

@category Array
*/
export type MultidimensionalReadonlyArray<Element, Dimensions extends number> = number extends Dimensions
	? Recursive<Element>
	: IsEqual<Dimensions, 0> extends true
		? Element
		: ReadonlyArray<MultidimensionalReadonlyArray<Element, Subtract<Dimensions, 1>>>;

Version data entries

33 entries across 33 versions & 1 rubygems

Version Path
immosquare-cleaner-0.1.60 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.59 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.58 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.57 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.56 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.55 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.54 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.53 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.52 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.51 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.50 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.49 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.48 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.47 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.46 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.45 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.44 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.43 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.42 node_modules/type-fest/source/multidimensional-readonly-array.d.ts
immosquare-cleaner-0.1.41 node_modules/type-fest/source/multidimensional-readonly-array.d.ts