es-toolkit/dist/bigint/rangeRight.d.mts

A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.

//#region src/bigint/rangeRight.d.ts
/**
 * Returns an array of bigints from `0n` up to, but not including, `end`, in descending order.
 *
 * @param end - The exclusive end of the range.
 * @returns An array of bigints.
 *
 * @example
 * const result = rangeRight(4n);
 * // result will be [3n, 2n, 1n, 0n]
 */
declare function rangeRight(end: bigint): bigint[];
/**
 * Returns an array of bigints from `start` up to, but not including, `end`, in descending order.
 *
 * @param start - The inclusive start of the range.
 * @param end - The exclusive end of the range.
 * @returns An array of bigints.
 *
 * @example
 * const result = rangeRight(2n, 5n);
 * // result will be [4n, 3n, 2n]
 */
declare function rangeRight(start: bigint, end: bigint): bigint[];
/**
 * Returns an array of bigints from `start` up to, but not including, `end`, incrementing by `step`,
 * in descending order.
 *
 * A negative `step` counts down. If `step` points away from `end`, an empty array is returned.
 *
 * @param start - The inclusive start of the range.
 * @param end - The exclusive end of the range.
 * @param step - The amount to increment by. Must not be `0n`.
 * @returns An array of bigints.
 * @throws {Error} If `step` is `0n`.
 *
 * @example
 * const result = rangeRight(0n, 10n, 2n);
 * // result will be [8n, 6n, 4n, 2n, 0n]
 */
declare function rangeRight(start: bigint, end: bigint, step: bigint): bigint[];
//#endregion
export { rangeRight };