有限循环 (For Loop)
有限循环 节点允许你在指定的数值范围内重复执行一段逻辑。它类似于编程语言中的 for 循环。
节点概览
- 分类: 逻辑 > 流程控制
- 内部ID:
mgmc:for_loop 
端口定义
| 端口名称 | 类型 | 说明 |
|---|
| 输入 (Exec) | 执行流 | 触发该节点的运行,开始循环。 |
| 循环起始值 (Start) | 整数 (Int) | 循环开始的整数值(包含)。默认为 0。 |
| 循环终止值 (End) | 整数 (Int) | 循环结束的整数值(包含)。默认为 10。 |
| 跳出循环 (Break) | 执行流 | 当此端口被触发时,立即停止当前循环,并跳转到“循环完成”端口。 |
输出 (Outputs)
| 端口名称 | 类型 | 说明 |
|---|
| 循环体 (Loop Body) | 执行流 | 每一轮循环都会触发一次该端口。 |
| 循环完成 (Completed) | 执行流 | 当所有轮次的循环执行完毕,或者循环被“跳出”后触发。 |
| 当前循环值 (Index) | 整数 (Int) | 输出当前循环的索引数值。 |
行为说明
- 执行流程:
- 节点被触发后,从“起始值”开始遍历到“终止值”。
- 每一步都会先设置“当前循环值”,然后触发“循环体”输出。
- 如果循环正常结束,最后会触发“循环完成”端口。
- 中断机制:在循环体执行过程中,如果通过逻辑连线触发了该节点的“跳出循环”输入端口,循环将立即停止。
- 闭包安全:循环内部使用了运行时数据隔离,确保多个循环嵌套或并发执行时不会互相干扰索引值。