All files / comparator/src nullishLast.ts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
1x
1x
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
4x
 
import { isNullish } from "@benneq/object";
import { predicateComparator } from "./predicateComparator";
 
/**
 *
 * @example
 * Sort an array with {@link @benneq/object!Nullish} values last
 * ```ts
 * const array = ["b", null, "a"];
 * array.sort(nullishLast(stringComparator));
 * console.log(array); // ["a", "b", null]
 * ```
 *
 * @typeParam T - the {@link Comparator} value type
 * @param comparator
 * @returns a {@link Comparator}
 */
export const nullishLast = predicateComparator(isNullish, false);