Lodash源码阅读-sortedLastIndex

Lodash 源码阅读-sortedLastIndex

概述

sortedLastIndex 是 Lodash 中的一个实用函数,用于确定一个值应该插入到已排序数组中的最高位置(最右侧),以保持数组的排序顺序。与 sortedIndex 不同,它返回的是最后一个不大于该值的位置之后的索引,这使得它特别适合处理包含重复元素的已排序数组。

这个函数在需要处理有序数据并保持元素顺序稳定性的场景中非常有用。它使用二分查找算法,时间复杂度为 O(log n),比线性搜索的 O(n) 要高效得多,尤其是在处理大型数组时。

前置学习

依赖函数

  • baseSortedIndex :内部函数,实现二分查找算法,根据 retHighest 参数返回不同的插入位置
  • identity:返回第一个参数的函数,当不需要额外处理时使用
  • isSymbol:检查值是否为 Symbol 类型的函数

技术知识

  • 二分查找算法:在有序数组中查找元素的高效算法,时间复杂度为 O(log n)
  • 稳定排序:理解保持相等元素相对顺序的重要性
  • 边界条件处理:处理数组边界和特殊值的技巧
  • 指数后移位操作 :>>> 操作符,用于快速整数除以 2 的计算

源码实现

javascript 复制代码
/**
 * This method is like `_.sortedIndex` except that it returns the highest
 * index at which `value` should be inserted into `array` in order to
 * maintain its sort order.
 *
 * @static
 * @memberOf _
 * @since 3.0.0
 * @category Array
 * @param {Array} array The sorted array to inspect.
 * @param {*} value The value to evaluate.
 * @returns {number} Returns the index at which `value` should be inserted
 *  into `array`.
 * @example
 *
 * _.sortedLastIndex([4, 5, 5, 5, 6], 5);
 * // => 4
 */
function sortedLastIndex(array, value) {
  return baseSortedIndex(array, value, true);
}

实现思路

sortedLastIndex 函数的实现思路非常简洁明了:它直接调用内部函数 baseSortedIndex,并传入 true 作为第三个参数(retHighest),以指示返回最高的合适索引。

baseSortedIndex 函数使用二分查找算法来确定插入位置,当 retHighest 为 true 时,它会查找最后一个不大于目标值的元素位置之后的索引。这意味着:

  1. 对于不存在于数组中的值,它返回该值应该插入的位置
  2. 对于已存在于数组中的值,它返回最后一个等于该值的元素之后的位置

这种设计使得 sortedLastIndex 特别适合处理包含重复元素的已排序数组,因为它能够找到最后一个匹配元素之后的位置。

源码解析

函数签名和文档

javascript 复制代码
/**
 * This method is like `_.sortedIndex` except that it returns the highest
 * index at which `value` should be inserted into `array` in order to
 * maintain its sort order.
 *
 * @param {Array} array The sorted array to inspect.
 * @param {*} value The value to evaluate.
 * @returns {number} Returns the index at which `value` should be inserted
 *  into `array`.
 */
function sortedLastIndex(array, value) {
  // 函数实现
}

函数文档清晰地说明了 sortedLastIndex 的用途:与 sortedIndex 类似,但返回的是最高的合适索引,即值应该插入到已排序数组中的最右侧位置,以维持数组的排序顺序。

函数接受两个参数:

  • array:已排序的数组
  • value:要评估的值

返回值是一个数字,表示 value 应该插入的索引位置。

函数实现

javascript 复制代码
function sortedLastIndex(array, value) {
  return baseSortedIndex(array, value, true);
}

函数实现非常简单,它直接调用 baseSortedIndex 函数,并传入三个参数:

  1. array:要检查的已排序数组
  2. value:要评估的值
  3. true:指示 baseSortedIndex 返回最高的合适索引

这种设计将复杂的实现细节封装在内部函数 baseSortedIndex 中,使公共 API 保持简洁。内部使用二分查找算法,通过比较当前元素与目标值来缩小搜索范围,最终找到合适的插入位置。

当 retHighest 参数为 true 时,它使用 <= 作为比较条件,这样可以确保找到最后一个不大于目标值的元素之后的位置。这种细微的比较逻辑调整使得 sortedLastIndex 与 sortedIndex 在处理重复元素时有着不同的行为。

总结

sortedLastIndex 函数是 Lodash 中一个简单但非常实用的工具函数,它通过二分查找算法高效地确定一个值应该插入到已排序数组中的最高位置。

相关推荐
feixing_fx6 小时前
第一个 JS 程序:在浏览器控制台和 Node 中分别运行
开发语言·前端·javascript·前端框架·ecmascript
feixing_fx8 小时前
变量与声明:let、const、var 的选择边界
开发语言·前端·javascript·前端框架
程序员大阳8 小时前
副队长Vue3教程(8)--列表渲染 v-for
javascript·vue3·v-for·列表渲染
JavaGuide10 小时前
Cloudflare 开源的这套神级安全审计 Skill 太好用了!
前端·后端
孟健11 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
feixing_fx11 小时前
JavaScript 是什么:从浏览器脚本到通用编程语言
开发语言·前端·javascript·前端框架·ecmascript
丘山望岳11 小时前
【开发工具】 cluade code常用快捷键
前端
小巫编程室12 小时前
我造了一个 Java 能力包:让 AI 直接调用你的业务代码
java·前端·后端
小y的笔记12 小时前
JavaScript URL 状态同步
前端·javascript
十有八七12 小时前
手搓 Agent(五):学会翻书——RAG,先查资料再回答
前端·人工智能·后端