@monstermann/fn/dist/array/atOrElse.js

A utility library for TypeScript.

import { dfdlT } from "@monstermann/dfdl";

//#region src/array/atOrElse.ts
/**
* `atOrElse(array, offset, fallback)`
*
* Returns the value at the specified `offset`. Calls `fallback` if the `offset` was out of range, or the retrieved value was nullable.
*
* ```ts
* atOrElse([1, null], -1, (array) => array.length); // 2
* ```
*
* ```ts
* pipe(
*     [1, null],
*     atOrElse(-1, (array) => array.length),
* ); // 2
* ```
*/
const atOrElse = dfdlT((target, offset, orElse) => {
	return target.at(offset) ?? orElse(target);
}, 3);

//#endregion
export { atOrElse };