/** * Compare two values in ascending order using JavaScript's built in comparison * operators. * * @example Comparing numbers * ```ts * import { ascend } from "../data-structures/mod.ts"; * import { assertEquals } from "../assert/mod.ts"; * * assertEquals(ascend(1, 2), -1); * assertEquals(ascend(2, 1), 1); * assertEquals(ascend(1, 1), 0); * ``` * * @typeparam T The type of the values being compared. * @param a The left comparison value. * @param b The right comparison value. * @returns -1 if `a` is less than `b`, 0 if `a` is equal to `b`, and 1 if `a` is greater than `b`. */ export declare function ascend(a: T, b: T): -1 | 0 | 1; /** * Compare two values in descending order using JavaScript's built in comparison * operators. * * @example Comparing numbers * ```ts * import { descend } from "../data-structures/mod.ts"; * import { assertEquals } from "../assert/mod.ts"; * * assertEquals(descend(1, 2), 1); * assertEquals(descend(2, 1), -1); * assertEquals(descend(1, 1), 0); * ``` * * @typeparam T The type of the values being compared. * @param a The left comparison value. * @param b The right comparison value. * @returns -1 if `a` is greater than `b`, 0 if `a` is equal to `b`, and 1 if `a` is less than `b`. */ export declare function descend(a: T, b: T): -1 | 0 | 1;