Skip to main content

Write Dynamic Variable(写入动态变量)

Write Dynamic Variable(写入动态变量)

Write Dynamic Variable 是一个 ProtoFlux 节点,用于向指定 Slot(插槽)下方已创建的动态变量写入数据。有关动态变量的更多信息,请参阅 Dynamic Variables。如图所示。

20260205211531_1.jpg

仅当写入的路径和数据类型与现有的变量完全一致时,该节点才会执行写入。关于路径如何判定相等(因为两个内容不同的路径仍可能指向同一个变量),请参阅 Dynamic Variables 页面的说明。

警告: 请务必注意,该节点最上方的输出脉冲是 OnNotFound(未找到)。如果你在连接节点时不加注意(误以为上方是成功),可能会导致代码执行后看起来没有任何反应,从而引起困惑。

节点接口概览

输入 (Inputs)
* (Call/调用) Impulse (脉冲)
Target (目标) Slot
Path (路径) String
Value (值) Generic (通用/自适应)
输出 (Outputs)
OnNotFound (未找到) Continuation (脉冲)
OnSuccess (成功) Continuation (脉冲)
OnFailed (失败) Continuation (脉冲)

输入

* (Call)

输入脉冲,触发写入变量的操作。

Target (Slot)

要在其中搜索目标动态变量的 Slot 层级结构。

Path (String)

用于查找可用动态变量的路径字符串。

Value (Generic)

需要写入现有变量的任何类型的值、引用或对象(类型需与目标变量匹配)。

输出

OnNotFound (Continuation)

当路径不正确,或在给定的 Slot 层级中找不到任何匹配的动态变量时触发。

OnSuccess (Continuation)

当输入脉冲触发,且通过 Target 成功找到并写入了变量时触发。

OnFailed (Continuation)

当输入脉冲触发,变量虽然被找到了,但无法被写入时触发(例如类型不匹配)。此时变量值不会发生改变。