西门子博途：声明WSTRING变量

机器人及PLC · 6 天前

数据类型为 WSTRING （宽字符串）的操作数用于在一个字符串中存储多个数据类型为 WCHAR 的 Unicode 字符。如果未指定长度，则字符串的长度为预置的 254 个字符。在一个字符串中，可使用操作系统支持的所有字符。这意味着也可在字符串中使用中文字符。Windows 仅支持 Unicode 定义的部分（大部分）字符。

声明数据类型为 WSTRING 的操作数时，可使用方括号定义其长度（例如，WSTRING[10]）。如果不指定长度，则在默认情况下，将 WSTRING 的长度设为 254 个字符。可声明最多 16382 个字符的长度 (WSTRING[16382])。

字符在单引号中指定，并且始终通过限定符 WSTRING# 指定。

下表列出了 WSTRING 变量的属性：

AlarmData[uiWritePtr_1].sRobot := WString#'R04';

长度（字）	格式	值范围	输入值示例
n + 2 1)	Unicode 字符串； n 指定字符串的长度。	预设值：0 到 254 个字符可能的最大值：0 到 16382	WSTRING#'Hello World' WSTRING#'Hello Wo...（该字符串的实际长度超出了屏幕空间。） WSTRING#'' (该字符串为空。)
1) 数据类型为 WSTRING 的操作数在存储器中占用的字数比指定的最大长度要多 2 个字。

字符串中还可包含特殊字符。转义字符 $ 可用于标识控制字符、美元符号和单引号。

下表给出了特殊字符表示法示例：

字符	十六进制	含义	示例
$L 或 $l	000A	换行	'$LText'、'$000AText'
$N	000A 和 000D	断行断行在字符串中占用 2 个字符，在编辑器的显示画面中将转换为 $R$L。	'$NText'、'$000A$000DText'
$P 或 $p	000C	分页	'$PText'、'$000CText'
$R 或 $r	000D	回车 (CR)	'$RText'、'$000DText'
$T 或 $t	0009	切换	'$TText'、'$0009Text'
$$	0024	美元符号	'100$$', '100$0024'
$'	0027	单引号	'$'Text$''、'$0027Text$0027'

如果转义字符 $ 后面跟有该表格中的某个字母，则表格中指定该字符将包含在字符串中。如果转义字符 $ 后面跟随的字母不在该表格中，则该字母将包含在该字符串中。如果转义字符 $ 后面跟随四个十六进制数字，则该代码将包含在字符串中。

监控表中的应用

监视一个数据类型为 WSTRING 的变量时，将仅显示前 254 个字符。如果实际长度大于 254 个字符，则将显示一个省略号 (…) 而非闭合撇号 (')。当 WSTRING 的值超过 254 个字符时，无法进行更改。

在 SCL 中使用

在极少数情况下，在 SCL 中使用 WSTRING 生成功能（如，CONCAT、INSERT、JOIN、SPLIT、LEFT、MID、RIGHT）生成超长的 WSTRING 时，WSTRING 结果可能会被系统截断。

因此，需检查这些功能的 ENO 是否为 FALSE，以确认 WSTRING 是否被截断。

字符串的最大长度

在操作数的声明过程中，可在关键字 WSTRING 后使用方括号指定字符串的最大长度（如，WSTRING[4]）。也可以使用局部或全局常量声明字符串的最大长度（如，WSTRING[loc_const] 或 WSTRING["glob_const"]）。如果未指定最大长度，则相应的操作数长度设置为标准的 254 个字符。

要声明 STRING 或 WSTRING 数据类型的变量，请按以下步骤操作：

在块接口中，选择需声明的部分。

在“名称”(Name) 列中输入一个变量名称。

在“数据类型”(Data type) 列中输入“STRING”或“WSTRING”。输入时系统将提供自动完成功能。

可选：在关键字 STRING 或 WSTRING 后面，使用方括号指定字符串的最大长度。如果未指定最大长度，则字符串的默认长度为 254 个字符。

最大长度为 4 的 WSTRING 示例：

WSTRING[4]

使用局部常量定义字符串最大长度的示例：

STRING[My_local_const1]

使用全局常量定义字符串最大长度的示例：

STRING["My_global_const1"]

STRING 和 WSTRING 的声明

STRING 和 WSTRING 数据类型存储一个字符串中的多个字符。允许在字符串中使用任何 ASCII 码类型的字符。这些字符将使用一个单引号括起。

可选择指定初始化字符串的默认值。

操作数声明期间，可在关键字 STRING 或 WSTRING 后使用方括号（例如 WSTRING[4]）指定字符串的最大长度。要声明最大长度，则可输入一个绝对值或使用局部/全局常量。

如果未指定最大长度，则相应的操作数长度设置为标准的 254 个字符。

语法

声明 STRING 和 WSTRING 所用的语法如下：

声明	语法	示例
STRING	<Name> : STRING [:= <Value>];	myString: STRING; myString: STRING := 'hello';
WSTRING	<Name> : WSTRING [:= <Value>];	myWstring: WSTRING; myWstring_var: WSTRING := 'helloWorld';
长度为定义的最大值的 STRING	<Name> : STRING[[Constant]];	myString: STRING[10]; myString: STRING["globConst"]; myString: STRING[locConst];