ResolveSymbols：解析多个符号 (S7-1500) 说明“解析多个符号”指令用于解析多个符号变量名称。执行该指令后，会收到对变量的引用。引 用属于类型化指针，可用于对变量进行读写访问。 在"nameList" 参数中指定 Array of WSTRING 。运行期间会通过此数组传送待解析的变量名称。该数组可位于优化的存储区或非优化存储区中。 在参数 "referenceList" 中指定保存引用的 Array ofResolvedSymbol (SDT)。ARRAY 需位于优 化存储区中。这两个数组的限值需相同。 符号变量名称以 WSTRING格式传输，且长度不得超过 254 个 UTF-16 字符。输入完全限定 的名称（包括命名空间）。不支持表示本地变量的限定符#。支持数组中的元素，但必须指 定固定下标才能访问元素。不支持通过可变下标（如myArray[myIndexTag]）进行访问。完全限定名称示例：使用 "firstIndex" 和 "lastIndex" 参数，可以仅解析列表中的部分符号。要解析整个符号列表，可在 "firstIndex" 参数中指定下限，在 "lastIndex" 参数中指定上限。该指令以异步方式执行。参数“"execute"”出现信号上升沿时开始执行。该指令在执行过程中 (Busy =1)，"nameList" 和 "referenceList"参数中的值无法更改。以下示例说明了如何使用指令“MoveResolvedSymbolsToBuffer”读取变量值并将其写入缓冲区中： • 在参数 "src" 中，指定包含对已解析变量引用的 Array of ResolvedSymbol (SDT) 。 • 在"dst" 参数中指定 Array of BYTE 。该数组用作写入变量值的目标缓冲区。 执行指令"MoveResolvedSymbolsToBuffer" 时，会通过引用读取变量值，并将其写入目标缓 冲区。 另请参见：MoveResolvedSymbolsToBuffer：从已解析的符号中读取值并写入缓冲区中。
对符号进行解析前，"referenceList" 参数中位于指定数组范围（"firstIndex"和"lastIndex"）内 的数组的值将复位。 该指令执行完成后，"done" 参数值将在一个周期内为 1。参数"referenceList" 中的数组会填 入对变量的引用。“execute”参数出现下降沿后，表示“ResolveSymbol”的实例不再处于激活状态。 说明 组态限值 每次Zui多可激活 10条 "ResolveSymbols" 指令。该指令的所有活动实例总共可解析Zui多 2000个符号。如果操作数“#Input_Execute”的信号状态更改为“1”，则该指令开始执行。对参数 "nameList"中的变量名称进行解析，并将变量引用写入参数 "referenceList" 中的操作数"#InOut_ResolvedSymbols"。该指令执行完成后，"done" 参数值将在一个周期内为 1。系统数据类型ResolvedSymbol (S7-1500) 说明 执行“运行期间进行符号化访问”功能需要使用系统数据类型"ResolvedSymbol"。该数据类 型会保存对 PLC 程序中变量的引用，并会保存用于生成这些引用的状态信息。系统数据类型需位于优化存储器中。 在固件版本 V3.0 及以上版本，系统数据类型“ResolvedSymbol”可声明为 PLC 数据类型的元素。 系统数据类型的结构 "ResolvedSymbol" 系统数据类型具有以下可见元素： 参数名称 数据类型 说明 resolvedBOOL 指示符号是否成功解析： • 已解析 = FALSE，且 STATUS = 0 => 尚未执行符号解析。 • 已解析 =FALSE + status <> 0 => 符号解析失败 status 参数的值指示变量中无法解析的结构等 级。负值表示无法解析符号，原因包括超出范围等。 正值表示变量不可访问或不可通过 HMI/OPC UA 或 Web API 写入。 •已解析 = TRUE，且 STATUS = 0 => 符号已成功解析。 • 已解析 = TRUE，且状态 <> 0=> 符号已成功解析，但该 DB 由“RUN”模式下 的后续加载结果覆盖。 status INT "resolved"元素用于指示某个符号是否已成功解析。如果符号已成功解析，"status" 参数的值 为 0，且 "ResolvedSymbol"结构中包含正确的信息。 除了这两个参数之外，系统数据类型还包含用于保存变量数据类型、长度和地址信息的内部参数，但这些参数不可访问。系统数据类型“ResolvedSymbol”中的无效引用 如果在 RUN模式下因加载导致被引用的变量覆盖，则 SDT "ResolvedSymbol" 中的引用可能变为无效。引用可能指向不存在的变量。"status" 参数中的错误代码指示引用无效。 以下示例中显示了出错时在 SCL 中如何使用IF 指令中断 Move 指令的执行以及如何重新解 析该符号：即使符号解析成功，执行„MoveResolvedSymbolToBuffer“ 时也可能出错。例如，在 RUN 模 式下因加载导致变量覆盖。此时，返回值„err“ 为复制失败的进程数。 如果识别到复制过程识别，则后续的 IF 指令将 "EnableMove" 设置为FALSE。这样，系统将 不再执行 "MoveResolvedSymbolsToBuffer"。 之后，FOR指令将进行检查，确定产生错误代码的相关符号。对于这些符号，会将错误代码 复制到 "status" 参数中。同时，参数“„resolved“”设置为 FALSE。现在需要再次使用异步操作指令 „ResolveSymbols“ 解 析符号。参见 运行期间进行符号化访问 (页 1719)MoveResolvedSymbolsToBuffer：从已解析的符号中读取值并写入缓冲区中 (S7-1500) 说明“从已解析的符号中读取值并写入缓冲区中”指令用于从多个已解析的符号中读取数值并写 入存储区 (Array of BYTE)中。采用这种方式，可准备符号解析后的相应值，进行后续处理。 如，通过诸如 TSEND 等通信指令进行发送。 "src" 参数是一个ResolvedSymbol (SDT) 数组，其中包含对之前通过“ResolveSymbols”指令解析的变量的引用。在“dst”参数中指定一个 BYTE 数组。该数组用作写入变量值的目标缓冲区。 这两个数组的限值需相同。 使用参数"firstIndex" 和 "lastIndex" 限制将在此次指令调用过程中复制的值列表。在后续的调用过程中，可复制其它已解析符号的值。如果不希望对列表进行限制，则 "firstIndex" 参 数中的值必须等于该列表的下限且"lastIndex" 参数中的值需等于该列表的上限。 "mode" 参数的值用于定义 "dst" 参数中的存储器格式。可通过偏移量确定目标缓冲区中已解析的符号值的存储位置。通过“dstOffsets”(Array of DINT)参数指定偏移量。每个偏移量均为位偏移，用于确定将值写入缓冲区时的起始位。可在一个 字节中存储多个 BOOL数据类型的值。其它所有数据类型的值的起始位位置必须可被 8 整除。 例如，如果 "src[i]" 参数引用一个数据类型为 REAL的变量，同时"dstOffsets[i]"参数中的值为 88，"mode" 参数值为2#1，则“从已解析的符号中读取值并写入缓冲区中”指令会将值复 制到字节 11 到 14 中（从Zui低有效字节开始）。
例如，如果 "src[i]"参数引用一个数据类型为 BOOL 的变量，同时 "dstOffsets[i]" 参数中的值 为29，则“从已解析的符号中读取值并写入缓冲区中”指令会将该值复制到字节为 3 并且 偏移量为 5 的目标存储器。 为确保"dstOffsets[i]" 中包含有 "src[i]" 的偏移量，"dstOffsets" 和 "src" 处的数组限值必须相同。 这样，可准确定义目标缓冲区的结构。但请注意，该指令不会验证所指定的偏移量是否重叠。此时，不会发送错误消息，而且目标缓冲区中的内容不确定。目标缓冲区中的内容同样取决于这是值从优化存储器中读取，或是从非优化存储器中。这两个存储区对字节填充的规则不同。有关字节填充的更多信息，请参见“另请参见”。 "status" 参数是一个 INT 数组。为确保"status[i]" 中包含有 "src[i]" 的状态，该参数的限值必 须与 "src" 和 "dstOffsets"参数的相同。 对于 WSTRING 和 STRING，将复制源字符串的当前长度。如果源字符串比目标字符串短，则目标字符串中的其余字符保持不变。 说明 SDT“ResolvedSymbol”中的引用无效 如果在 RUN模式下因加载导致被引用的变量覆盖，则 SDT "ResolvedSymbol" 中的引用可能变为无效。引用可能指向不存在的变量。“status”参数中的错误代码指示引用无效。此时，需使用“ResolveSymbols”指令对该符号进行重新解析。 参数下表列出了“从已解析的符号中读取值并写入缓冲区中”指令的参数： 参数 声明 数据类型 存储区 说明 firstIndex InputDINT I、Q、M、D、 L、C 待复制的第一个 已解析符号的下 标。 lastIndex Input DINT I、Q、M、D、L、C 待复制的Zui后一 个已解析符号的 下标。 src Input Array of ResolvedSymbol D、L已解析的符号列 表。