跳转至

GetIndexOfItem 列表元素索引位置检索节点

节点核心功能 (What is it?)

GetIndexOfItem 节点是一个实用的列表检索工具节点，用于在给定的列表中查找特定目标元素所处的物理索引位置（Index）。它会检索并返回该元素在列表中首次出现的以 0 为基底（0-based）的整数下标。

典型适用场景 (When would I use it?)

在以下情况下使用 GetIndexOfItem 节点：

  • 查询特定数据项在现有列表中的具体排布序号；
  • 在数据集合中快速定位特定标志位或关键词的位置；
  • 构建依据元素相对位置进行条件分流或切片的工作流；
  • 校验元素在列表序列中的先后顺序合法性；
  • 动态追踪特定数据项在列表演算过程中的位置迁移。

使用指南 (How to use it)

基础配置流程 (Basic Setup)

  1. 在工作流画布中添加 GetIndexOfItem 节点。
  2. 将母列表连接至 items 输入插槽。
  3. 将待查找的目标元素连接至 item 输入插槽。
  4. 节点的 index 输出引脚将即刻吐出该元素所在的数字下标值。

参数输入插槽 (Parameters)

  • items：待执行检索的母列表（list 类型输入引脚）。
  • item：待在列表中检索的目标元素项（支持任意数据类型 any）。

输出引脚 (Outputs)

  • index：表示目标元素在列表中首次出现位置的整数下标；若未在列表中检索到该元素，则返回 -1。

典型工作流示例 (Example)

在代办任务清单中检索特定关键任务的排位序号：

  1. 在画布中添加 GetIndexOfItem 节点。
  2. 将上游的任务清单列表连入 items 输入端。
  3. 将包含 "完成技术文档评审" 文本的节点连入 item 输入端。
  4. 节点的 index 输出引脚将输出该任务在清单中的具体排序下标（例如 2）。

关键技术特性 (Important Notes)

  • 未找到保底标记：若目标项不存在于列表中，节点将明确返回 -1，便于下游使用 Math 或逻辑判断节点分支判定；
  • 0 索引基底：遵循标准计算机索引规范，列表首项元素的索引下标为 0；
  • 首处匹配原则 (First Occurrence)：若列表中存在多个完全相同的重复项，节点仅返回第一个匹配项的下标；
  • 响应式数据流：当输入的母列表或检索项发生任何变化时，节点的索引输出会自动同步更新。

常见问题与排查 (Common Issues)

  • 输出为 -1：若输出结果为 -1，表明列表中未找到完全匹配项，或上游列表/待查项引脚处于未连接状态。
  • 字符串大小写敏感 (Case Sensitivity)：若待检索项为文本字符串，底层的等值比较严格区分大小写（例如 "Apple" 与 "apple" 不匹配）。
  • 对象数据类型匹配 (Type Mismatch)：待检索项的数据类型必须与列表内存储项的数据类型严格一致（例如整数 42 与字符串 "42" 不相等）。