跳到正文
Learn-LAD
梯形图示例库/LAD 指令手册/GetInstanceName — 读取实例名

GetInstanceName — 读取实例名

返回当前实例名称(WString)。

其他 S7-1200/1500 TIA V19 别名:实例名 / GetInstanceName

在 TIA 里试一下

选一个示例块,通过 TiaLink 导入当前 TIA 项目:预检、默认不覆盖、不自动保存。示例块不会自动运行;导入后请在 OB1 调用并接变量。

TiaLink 设置

默认 http://localhost:8080。也可以在本页地址后加 ?tialink= 临时指定。

TiaLink 启动时若设置了 --api-token,这里要填相同的值;只保存在本机浏览器 localStorage,不会上传。

一句话

GetInstanceName 返回当前实例名称(WString)。

符号与引脚

分类:其他 不需要实例 模板值:无
引脚方向说明
en流输入使能输入
size输入结果缓冲大小
OUT输出实例名(WString)

符号见下面的最小示例;引脚名与方向来自 lad-ir 指令目录,说明为本站补充。

最小示例

Enable=1 时 Name = GetInstanceName(Size);Size 给结果缓冲大小。

GetInstanceName_Example:Network 1 — GetInstanceName — 读取实例名

图中 # 前缀表示块内局部变量;实际工程里也可以是全局标签或 DB 变量。

怎么工作

  • size 是结果缓冲大小(字符数)。
  • 输出是 WString;EN 是使能,没有 ENO。
  • 这是 terminal 盒,rung 在它这里结束。
  • 常用于 FB/多重实例里的诊断。

常用场景

1. 读取实例名

同上面的最小示例。

2. 诊断日志

把实例名写进报警/日志,区分同一 FB 的多个实例。

GetInstanceName_InstanceName:Network 1 — 读取实例名

常见坑

  • WString 不是 String:输出类型是 WString。
  • size 太小:名称会被截断。
  • terminal:后面不能再接线圈/盒。
  • 上下文:实例名来自当前调用环境,和块名不同。

← 返回 LAD 指令手册