将数值型转换为字符串型

将数字值（十进制或十六进制）转换为字符串。

[Source Data]中的数字将转换为[Source Data Format]中指定数据格式（十进制或十六进制）的字符串，并存储在[Destination Data]中。

TARGET = toString(EXPRESSION, 10, 0);
1 5 2 3/4

描述

[Destination Data]

设置目标以存储转换后的字符串。

[Source Data Format]

选择以下格式之一：

[Zero Suppress]

选择复选框，以禁止在数值前面显示零。清除复选框，指定 [Integer Digits] 的数量，并在数值前面添加零以与位数对齐。

(示例) [Source Data]: 25, [Integer Digits]: 4
选中复选框（启用）时：	25
清除复选框（禁用）时：	0025

设置 '0’ 以禁止在数值前面显示零。设置一个介于 '1’ 至 '20’ 之间的数值，指定 [Integer Digits] 的数量，并在数值前面添加零以与位数对齐。

[Integer Digits] 指定要转换的字符串中的位数。设置值范围: 1 - 20 当 [脚本模式] 为 [块]， [Zero Suppress] 复选框被清除时，设置此值。

[Source Data] 设置源数据，存储要转换的数字。

(示例)

Var3=toString(Var1,10,0);

操作示例

[Source Data]中的变量		[Zero Suppress]	[Integer Digits]	[Destination Data]中的变量		注解
数据类型和值	格式	[Zero Suppress]	[Integer Digits]	最大字节数	转换后字符串	注解
INT: 100 (0x64)	Decimal	启用	-	5	100	-
		启用	-	1	(无)	由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
		禁用	4	5	0100	添加“0”以与在 [Integer Digits]中指定的位数对齐。
			2	5	100	即使值超过[Integer Digits],也要设置转换后的字符串。
			6	5	(无)	由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
			6	使用[变量长度]	000100	添加“0”以与在 [Integer Digits]中指定的位数对齐。
	Hex	启用	-	5	64	-
		启用	-	1	(无)	由于转换后的字符串已超过可以存储的最大字节数，未存储字符串。在“操作结果”操作中判断为失败。
		禁用	4	5	0064	添加“0”以与在 [Integer Digits]中指定的位数对齐。
		禁用	6	使用[变量长度]	000064	添加“0”以与在 [Integer Digits]中指定的位数对齐。
INT: -100 (0xFF9C)	Decimal	启用	-	5	-100	"-”支持减号。
	Decimal	禁用	4	5	-0100	"-”支持减号。
	Hex	启用	-	5	FF9C	-
REAL: 100.00	Decimal	启用	-	5	100	仅整数部分被转换。
REAL: 100.00	Hex	启用	-	5	64	仅整数部分被转换。
REAL: 100.678	Decimal	启用	-	5	100	仅整数部分被转换。
BOOL: true	-	-	-	5	True	-
BOOL: false	-	-	-	5	False	-

注：即使将以下日期类型值之一设置为 [Source Data]，该值也不会从日期/时间格式转换为字符串。该值从整数格式转换为字符串。

日期 / 时间格式: 8/19/2020 10:19:00 AM

整数格式 ([Source Data Format]: [Dec]): 1597799940

整数格式 ([Source Data Format]: [Hex]): 5F3C7E04