All files / comparator/src nullLast.ts

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