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

GetBlockName — 读取块名

返回当前块名称(WString)。

其他 S7-1200/1500 TIA V19 别名:块名 / GetBlockName

在 TIA 里试一下

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

TiaLink 设置

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

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

一句话

GetBlockName 返回当前块名称(WString)。

符号与引脚

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

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

最小示例

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

GetBlockName_Example:Network 1 — GetBlockName — 读取块名

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

怎么工作

  • size 是结果缓冲大小(字符数),要足够放下块名。
  • 输出是 WString;EN 是使能,没有 ENO。
  • 这是 terminal 盒,rung 在它这里结束。
  • 常用于日志/诊断:把当前块名写进消息。

常用场景

1. 读取块名

同上面的最小示例。

2. 日志/诊断

把块名和错误码一起记录,定位问题更快。

GetBlockName_BlockName:Network 1 — 读取块名

常见坑

  • WString 不是 String:输出类型是 WString。
  • size 太小:名称会被截断;按最大长度留余量。
  • terminal:后面不能再接线圈/盒。
  • 上下文:在 FC/FB 里返回的名称含义不同,按 TIA 文档确认。

← 返回 LAD 指令手册