跳转至

Get From List 列表定点索引取值节点

Get From List 节点接收一个列表和一个目标数字下标索引作为输入,并提取返回该列表中对应下标位置的元素项。

输入引脚与面板属性 (Inputs)

  • items(list):待提取目标元素的母列表。
  • index(int):待提取元素的目标 0-based 数字索引下标(支持连线输入或在面板属性中直接指定)。

输出引脚规范 (Outputs)

  • item(any):指定索引下标位置的元素项。如果下标越界、非法或缺失必要输入,则安全返回 None。

使用示例 (Example)

# 输入列表 items: [1, 2, 3, 4, 5]
# 输入索引 index: 2
# 提取输出 item: 3

关键技术特性 (Notes)

  • 安全边界保护:若指定的 index 超出列表有效范围(越界)或属于非法值,节点不会抛出崩溃异常,而是优雅返回 None;
  • 缺失输入保底:若列表或索引中任意一个输入项未连接或缺失,节点同样平滑返回 None;
  • 多态任意类型输出:因为母列表可以容纳任意类型的数据,输出端 item 的类型标记为多态 any;
  • 双模输入支持:index 参数既可以通过外部整数引脚动态接入,也可以在节点面板属性中直接静态设定。