UNPKG

remeda

Version:

A utility library for JavaScript and Typescript.

45 lines 1.71 kB
//#region src/sortedIndex.d.ts /** * Find the insertion position (index) of an item in an array with items sorted * in ascending order; so that `splice(sortedIndex, 0, item)` would result in * maintaining the array's sort-ness. The array can contain duplicates. * If the item already exists in the array the index would be of the *first* * occurrence of the item. * * Runs in O(logN) time. * * @param data - The (ascending) sorted array. * @param item - The item to insert. * @returns Insertion index (In the range 0..array.length). * @signature * R.sortedIndex(data, item) * @example * R.sortedIndex(['a','a','b','c','c'], 'c') // => 3 * @dataFirst * @category Array * @see sortedIndexBy, sortedIndexWith, sortedLastIndex, sortedLastIndexBy */ declare function sortedIndex<T>(data: ReadonlyArray<T>, item: T): number; /** * Find the insertion position (index) of an item in an array with items sorted * in ascending order; so that `splice(sortedIndex, 0, item)` would result in * maintaining the array's sort-ness. The array can contain duplicates. * If the item already exists in the array the index would be of the *first* * occurrence of the item. * * Runs in O(logN) time. * * @param item - The item to insert. * @returns Insertion index (In the range 0..array.length). * @signature * R.sortedIndex(item)(data) * @example * R.pipe(['a','a','b','c','c'], R.sortedIndex('c')) // => 3 * @dataLast * @category Array * @see sortedIndexBy, sortedIndexWith, sortedLastIndex, sortedLastIndexBy */ declare function sortedIndex<T>(item: T): (data: ReadonlyArray<T>) => number; //#endregion export { sortedIndex }; //# sourceMappingURL=sortedIndex-Byj-w348.d.ts.map