代码存储器空间需求大幅增加 使用GetSymbolName 将导致代码存储器空间需求大幅增加。指令的调用频率越高，实际符 号越长，对存储器的空间要求也就越大。 说明运行时间延长 由于要准备符号信息，使用“GetSymbolName”会导致程序运行时间显著延长。因此，强烈建议不要循环调用“GetSymbolName”。可以在发生过程错误时进行错误检测或在启动例程中进行调用。如果在项目中多次使用块，且每次都由不同的变量调用，那么可以使用“GetSymbolName”指令来评估调用变量的名称。在这种情况下，与变量的过程值无关。 • 在 VARIABLE参数处指定块接口的输入参数。仅为该参数使用接口参数，并且没有 PLC 或 数据块变量。 • 要限制读取变量名称的长度，可使用 SIZE参数。如果名称已被截断，将由名称末尾处的 字符“...”（Unicode 字符 16#2026）指示。请注意，该字符的长度为 1。在以下示例中，说明了 SIZE 参数的含义。通过块接口，读取以下变量名 称："MyPLCTag"（左右双引号为名称的一部分。）SIZE GetSymbolName 返回 说明 1 '...' • WSTRING 的第一个字符：' • 被截断名称的标识符：...• WSTRING 的Zui后一个字符：' 2 '"...' • WSTRING 的第一个字符：' •名称的第一个字符和被截断名称的标识符："... • WSTRING 的Zui后一个字符：' 3 '"M...' • WSTRING的第一个字符：' • 名称的前两个字符和被截断名称的标识符："M... • WSTRING 的Zui后一个字符：' 6'"MyPL...' • WSTRING 的第一个字符：' • 名称的前五个字符和被截断名称的标识 符："MyPL... •WSTRING 的Zui后一个字符：' 0 '"MyPLCTag"' • WSTRING 的第一个字符：' •该名称的所有字符："MyPLCTag" • WSTRING 的Zui后一个字符：' • 名称读取在 OUT 参数中输出。
下表列出了“GetSymbolName”指令的参数： 参数 声明 数据类型 存储区 说明 VARIABLEInput PARAMETER Input、 Output、 InOut 参数区 域 选择读取输入参数名称的本地接口。 SIZEInput DINT I、Q、M、 D、L OUT 参数处，输出字符数的限值。 • SIZE > 0：GetSymbolName返回名称的前 SIZE 个字符。 • SIZE = 0：GetSymbolName 返回整个名称。 • SIZE <0：GetSymbolName 返回名称的Zui 后 SIZE 个字符。 OUT Return WSTRING D、L输出输入参数的变量名称 有关有效数据类型的更多信息，请参见“有效数据类型概述 (页 255)”。 示例在以下示例中，通过块的输入参数读取互连的变量的名称。 在全局数据块中创建两个用于存储数据的变量。创建函数“SLI_FC_GetSymbolName”。在块中创建以下局部变量。在函数中调用“GetSymbolName”，并互连“GetSymbolName”，如下所示：在块“SLI_FC_GetSymbolName”中，执行指令“GetSymbolName”。使用指令的输入参数VARIABLE，可检查“SLI_FB_GetSymbolName”块中输入参数 inputValue 的互连情况。为执行此操作，读取“symbolVALUE”变量并通过输出参数 OUT（“MySymNAME”）将其作为字符串 输出。根据输入参数 SIZE的值，字符串的长度被限制为 60 个字符。从调用路径起始处，查询实参 GetSymbolPath:。 (S7-1200,S7-1500) 说明 使用指令“GetSymbolPath”，读取在调用路径起始处通过多个块调用传送的参数名称。 说明 OB中的直接调用 在 OB 中，不能直接调用“GetSymbolPath”指令。 说明 代码存储器空间需求大幅增加 使用GetSymbolPath 将导致代码存储器空间需求大幅增加。指令的调用频率越高，实际符 号越长，对存储器的空间要求也就越大。 说明运行时间延长 由于要准备符号信息，使用“GetSymbolPath”会导致程序运行时间显著延长。此外，运行时间的增加在很大程度上与调用“GetSymbolPath”时调用堆栈上的块数量相关：运行时间的增加在很大程度上与调用“GetSymbolPath”时调用堆栈上的块数目相关。因此，强烈建议不要循环调用“GetSymbolPath”。可以在发生过程错误时进行错误检测或在 启动例程中进行调用。• 在指令的参数VARIABLE 处，可指定运行过程中调用已互连实参时待读取的形参名称。 –如果使用数据块的变量作为输入参数，则将输出包含有数据块名称与到结构化变量访 问路径的变量。 – 如果使用 PLC变量提供输入参数，则输出 PLC 变量的名称。 – 如果使用常数作为输入参数，则输出该常数。 • 要限制读取变量名称的长度，可使用SIZE 参数。如果名称被截断，则在该名称的末尾处 将标识为字符“...”（Unicode 字符16#2026）。请注意，该字符的长度为 1。 在以下示例中，说明了 SIZE 参数的含义。通过该块接口，可读取以下变量名称："MyPLCTag"（左右双引号为名称的一部分。） SIZE GetSymbolPath 返回 说明 1 '...' •WSTRING 的第一个字符：' • 被截断名称的标识符：... • WSTRING 的Zui后一个字符：' 2 '"...' •WSTRING 的第一个字符：' • 名称的第一个字符和被截断名称的标识符："... • WSTRING 的Zui后一个字符：' 3'"M...' • WSTRING 的第一个字符：' • 名称的前两个字符和被截断名称的标识符："M... • WSTRING的Zui后一个字符：' 6 '"MyPL...' • WSTRING 的第一个字符：' • 名称的前五个字符和被截断名称的标识符："MyPL... • WSTRING 的Zui后一个字符：' 0 '"MyPLCTag"' • WSTRING 的第一个字符：' •该名称的所有字符："MyPLCTag" • WSTRING 的Zui后一个字符：'下表列出了“GetSymbolPath”指令的参数：参数 声明 数据类型 存储区 说明 VARIABLE Input PARAMETER Input、Output、 InOut 参数区域选择形参，在调用路径起始处将读取其对 应实参的名称。 SIZE Input DINT I、Q、M、D、L 或 常量 OUT参数处，输出字符数的限值。 • SIZE > 0：GetSymbolPath 返回名称的 前 SIZE 个字符。 • SIZE= 0：GetSymbolPath 返回整个名 称。 • SIZE < 0：GetSymbolPath 返回名称的 Zui后SIZE 个字符。 OUT Output WSTRING D、L 输出输入参数来源的变量名称。有关有效数据类型的更多信息，请参见“有效数据类型概述 (页 255)”。 示例 以下示例说明了如何在多个调用级别上使用GetSymbolPath： • 将从组织块 OB1 中调用 FB_Level_1 块。之后，将依次调用 FB_Level_2 块。• GetSymbolPath 将在块 FB_Level_2 中执行，读取参数名称，在调用路径起始处开头处该 参数的值将传递到REQ2 中。 • 在参数 REQ1 处，变量 MyStarterBit 作为实参进行连接。该位在 MyDatablock 数据块的MySTRUCT 结构中。 此信息由 GetSymbolPath 读取，并通过 OUT参数输出。有关上述示例的更多信息和程序代码，请参见“Sample Library for Instructions(页 713)” 参见 转换程序状态的显示格式 (页 10442) GetInstanceName：读取实例的名称(S7-1200, S7-1500) 说明 可以使用“GetInstanceName”指令在函数块中读取背景数据块的名称。 说明 OB中的直接调用 在 OB 中，不能直接调用“GetInstanceName”指令。代码存储器空间需求大幅增加 使用GetInstanceName 将导致代码存储器空间需求大幅增加。指令的调用频率越高，背景数据块的名称越长，对名称长度的限制越小，因而对存储器空间的要求也就越大。 说明 运行时间延长由于要准备符号信息，使用“GetInstanceName”会导致程序运行时间显著延长。因此，强烈建议不要循环调用“GetInstanceName”。可以在发生过程错误时进行错误检测或在启动例程 中进行调用。 •要限制读实例名称的长度，可使用 SIZE 参数。如果名称被截断，则在该名称的末尾处将 标识为字符“...”（Unicode 字符16#2026）。请注意，该字符的长度为 1。 在以下示例中，说明了 SIZE 参数的含义。通过块接口，读取以下实例名称："Level1_DB"（左右双引号为名称的一部分。）• 背景数据块的名称将写入 OUT 参数中。如果该背景数据块的名称的长度大于WSTRING 的 Zui大长度，则该名称将将截断。 对于多实例数组中的某个元素，GetInstanceName不返回下标数值，而是返回符号。在以下示例中，读取背景数据块的名称。 在全局数据块中创建两个用于存储数据的变量。创建函数块“SLI_FB_GetInstanceName”。互连“GetInstanceName”指令的参数，如下所示：在块“SLI_FB_GetInstanceName”中，执行指令“GetInstanceName”。通过指令“GetInstanceName”，确定块“SLI_FB_GetInstanceName”已关联的背景数据块，并通过输出 参数OUT（“outputInstName”）将其作为字符串输出。根据参数 SIZE（“limitSIZE”）的值“0”，字符串的长度不受限制。