All files / iterable/src min.ts

100% Statements 9/9
100% Branches 5/5
100% Functions 3/3
100% Lines 8/8

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 331x 1x 1x                                   3x       3x 5x 3x   2x        
import { isGreaterThan, Comparator } from "@benneq/comparator";
import { isUndefined } from "@benneq/object";
import { reduce } from "./reduce";
 
/**
 * Get the minimum element from an {@link Iterable} by comparing its elements
 * using a {@link Comparator}.
 *
 * @example
 * Find min number in Array
 * ```ts
 * const findMinNumber = min(numberComparator);
 * const minNumber = findMinNumber([1,2,3]);
 * console.log(minNumber); // 1
 * ```
 *
 * @typeParam T - the {@link Iterable} value type
 * @param comparator - the {@link Comparator} to use
 * @returns the minimum element, or `undefined` if the {@link Iterable} is empty
 */
export const min = <T>(
  comparator: Comparator<T>,
  minValueIsGreater = isGreaterThan(comparator)
): ((iterable: Iterable<T>) => T | undefined) => {
  return reduce<T, T | undefined>((minValue, value) => {
    if (isUndefined(minValue) || minValueIsGreater(minValue, value)) {
      return value;
    } else {
      return minValue;
    }
  }, undefined);
};