length.ts

import { always } from "@lou.codes/utils";
import { reduce } from "./reduce.js";

/**
 * Get the length of an iterable or asynchronous iterable.
 *
 * @category Asynchronous Reducers
 * @example
 * ```typescript
 * length([1, 2, 3]); // 3
 * ```
 * @param iterable Iterable or asynchronous iterable to get the length from.
 * @returns Promise with the length of the iterable.
 */
export const length = reduce(always((total: number) => total + 1))(0);