设置列表项 (Set List Item)
- 分类: 变量 -> 列表
- 内部 ID:
list_set_item
节点功能
修改列表中指定索引位置的项目内容，或者在列表末尾追加新项目。
入参
| 端口名称 | 内部 ID | 类型 | 说明 |
|---|---|---|---|
| 列表输入 | list_in | 列表 (LIST) | 需要修改的原始列表。 |
| 索引 | index | 浮点数 (FLOAT) | 目标位置的索引（从 0 开始）。 |
| 新值 | value | 任意 (ANY) | 要写入的新内容。 |
出参
| 端口名称 | 内部 ID | 类型 | 说明 |
|---|---|---|---|
| 列表输出 | list_out | 列表 (LIST) | 修改后的新列表。 |
逻辑规则
- 替换逻辑：如果指定的索引在列表的有效范围内（从 0 到 长度-1），该位置的旧内容将被新值覆盖。
- 追加逻辑：如果指定的索引正好等于列表的当前长度，新值将被添加到列表的末尾。
- 越界保护：如果索引小于 0 或大于列表长度，节点将不会进行任何修改，直接返回原始列表。
- 空列表处理：如果输入的列表为空，输出将直接是新值。