@thi.ng/arrays/arg-sort.d.ts

Array / Arraylike utilities

import type { Comparator } from "@thi.ng/api";
/**
 * Returns a new array of numeric indices in same order as sorted values of
 * `src` using given (optional) comparator (default: thi.ng/compare). The `src`
 * array will remain unmodified.
 *
 * @remarks
 * Also see {@link swizzle} to read an array in custom order.
 *
 * @example
 * ```ts tangle:../export/arg-sort.ts
 * import { argSort, swizzle } from "@thi.ng/arrays";
 *
 * const src = ["a", "c", "d", "b"];
 *
 * console.log(
 *   argSort(src)
 * );
 * // [ 0, 3, 1, 2 ]
 *
 * // src[0] => "a"
 * // src[3] => "b"
 * // src[1] => "c"
 * // src[2] => "d"
 *
 * console.log(
 *   swizzle(argSort(src))(src)
 * );
 * // [ 'a', 'b', 'c', 'd' ]
 * ```
 *
 * @param src -
 * @param cmp -
 */
export declare const argSort: <T>(src: Iterable<T>, cmp?: Comparator<T>) => number[];
//# sourceMappingURL=arg-sort.d.ts.map