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参数既可以通过外部整数引脚动态接入,也可以在节点面板属性中直接静态设定。