威纶通触摸屏宏指令字符串函数 - 工控编程吧

(, 下载次数: 4)

上传

点击文件名下载附件

read_data的类型 data_count 的值读取16 位数据的个数

char(8-bit) 1 1

char(8-bit) 2 1

因为一个 WORD (16 位) 等于 2 个 ASCII 字符的长度，当设备类型长度为 WORD

时，根据上表，读取 2 个 ASCII 字符实际上是读 1 个 WORD 的数据。

例如：

macro_commandmain()

charstr1[20]

// 读取 LW-0 ~ LW-9 共 10 个 WORD 到变数 str1[0] 到 str1[19] 中

// 因 1 WORD 可存放 2 个 ASCII 字符，欲读取 20 个 ASCII 字符

// 实际上共读取了 10 个WORD

StringGet(str1[0],‚Local HMI‛, LW, 0, 20)

endmacro_command

2. StringGetEx

语法 StringGetEx (read_data[start], device_ 函数名称 , device_type,address_offset, data_count)

获取 PLC 的数据，不等待 PLC 响应，径自往下执行。

read_data、device_函数名称、device_type、address_offset 和 data_count 的说明

和 GetData 相同。

例如：

macro_commandmain()

charstr1[20]

shorttest=0

// 当 MODBUS 设备未回应，test = 1将照常执行

StringGetEx(str1[0],"MODBUS RTU", 4x, 0, 20)

test = 1

// 当 MODBUS 设备未响应，test = 2 将不会被执行，直到得到响应

StringGet(str1[0],"MODBUS RTU", 4x, 0, 20)

test = 2

endmacro_command

3. StringSet

语法 StringSet (send_data[start], device_ 函数名称 ,device_type, address_offset, data_count)

将数据写到 PLC 中。字符串数据保存在

send_data[start]~send_data[start+data_count-1]中，send_data 必须为一维

字符数组类型。

data_count是写入到 PLC 中字符数据的个数，可以是常数也可以是变量。

device_函数名称详见上面的说明，在此不再说明。

device_type是设备类型和 PLC 中数据的编码方式。例如：如果 device_type 是

LW_BIN，那么读取的设备类型为 LW，数据编码方式为 BIN。如果使用 BIN 编码方

式，“_BIN” 可以忽略。

如果 device_type 是 LW_BCD，表示设备类型 LW，数据的编码方式为 BCD格式。

address_offset是 PLC 中的地址偏移量。

例如，StringSet(read_data_1[0],“FATEK FB Series”, RT, 5, 1) 代表读取的设备地

址偏移量为 5。

如果 address_offset 使用格式为 “N#AAAAA”， N 表示 PLC 的站号， AAAAA 表

示地址偏移量。此情况一般使用在同一个串行埠上连接有多台 PLC 或者控制器的情

况下。例如：StringSet(send_data_1[0],“FATEK FB Series”, RT, 2#5, 1) 表示设

定站号为 2 的 PLC 的数据。如果 StringSet() 使用 “系统参数 / 设备列表” 中设

定的默认的站号，在此可以不填这个站号。

设定到 PLC 的资料个数，根据 data_count 的值来决定，因 send_data 变量仅接

受 char 数组类型。如下所示：

sead_data的类型 data_count 的值设定 16 位数据的个数

char(8-bit) 1 1

char(8-bit) 2 1

因为一个 WORD (16 位) 等于 2 个 ASCII 字符的长度，当设备类型长度为 WORD

时，根据上表，写入 2 个 ASCII 字符实际上是写 1 个 WORD 的数据。宏指令会

以先写 low byte 再写 hight byte 的顺序，依序将 ASCII 字符写入。

使用 “字符显示” 元件显示数据时，data_count 必须填入 2 的倍数才能正确显示。

如：macro_commandmain()

charsrc1[10]="abcde"

StringSet(src1[0],"Local HMI", LW, 0, 5)

endmacro_command

当 data_count 为一个大于或等于字符串长度的偶数时，可以完整显示整个字符串：

macro_commandmain()

charsrc1[10]="abcde"

StringSet(src1[0],"Local HMI", LW, 0, 6)

endmacro_command

例如：

macro_commandmain()

charstr1[10]= ‚abcde‛

// 字符串 str1 写入 LW-0 ~ LW-2 共三个 WORD

// 即使 data_count 为 10，写到第 3 个 WORD 时发现字符串已结束，

// 便不再写入后面的数据

StringSet(str1[0],"Local HMI", LW, 0, 10)

end macro_command

4. StringSetEx

函数名称 StringSetEx

语法 StringSetEx(send_data[start], device_ 函数名称 ,device_type, address_offset, data_count)

将数据写到 PLC 中，不等待 PLC 回应，径自往下执行。

send_data、device_函数名称、device_type、address_offset 和 data_count的说明

和 StringSet 相同。

例如：

macro_commandmain()

charstr1[20]= ‚abcde‛

shorttest=0

// 当 MODBUS 设备未回应，test = 1 将照常执行

StringSetEx(str1[0],"MODBUS RTU", 4x, 0, 20)

test = 1

// 当 MODBUS 设备未响应，test = 2 将不会被执行，直到得到响应

StringSet(str1[0],"MODBUS RTU", 4x, 0, 20)

test = 2

endmacro_command

5. StringCopy

语法 success = StringCopy ([source],destination[start])

或

success= StringCopy (source[start], destination[start])

利用此函数进行字符串的复制。此函数可以将传入的静态字符串 (以双引号‛‛

括起来的字符串)，或是存放在字符数组中的字符串复制到目的 buffer。

来源字符串 sourc e可以为静态字符串 (如 ‚source‛ )或是一维字符数组变量

(如source[start])。

Destination[start] 必须为一维字符数组变量。

复制完毕会回传一 bool 类型的值给 success 字段。当复制成功，success等于

true，否则等于 false。当来源字符串的长度大于目的 buffer 的大小时，将不做任

何处理，并回传 false 到 success 字段。

success 字段可写可不写。

例如：

macro_commandmain()

charsrc1[5] = "abcde"

chardest1[5]

boolsuccess1

success1= StringCopy(src1[0], dest1[0])

//success1=true，dest1为 ‚abcde‛

chardest2[5]

boolsuccess2

success2= StringCopy("12345", dest2[0])

//success2 = true，dest2为 ‚12345‛

charsrc3[10] = "abcdefghij"

chardest3[5]

boolsuccess3

success3= StringCopy(src3[0], dest3[0])

//success3 = false，dest3内容不变

charsrc4[10] = "abcdefghij"

chardest4[5]

boolsuccess4

success4= StringCopy(src4[5], dest4[0])

//success4=true，dest4为 ‚fghij‛

endmacro_command

6. StringDecAsc2Bin

success= StringDecAsc2Bin(source[start], destination)

或 success = StringDecAsc2Bin(‚source‛,destination)

此函数将十进制字符串转换成整数。

来源字符串 source 可以为静态字符串 (如 ‚source‛ )或是一维字符数组变量

(如source[start])。

destination 必须为一变量，用以存放转换后的整数值。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

来源字符串必需为十进制字符串，若其包含 ‘0’ ~ ‘9’ 以外的字符，函数将

会回传false。

success 字段可写可不写。

例如：

macro_commandmain()

charsrc1[5] = "12345"

intresult1

boolsuccess1

success1= StringDecAsc2Bin(src1[0], result1)

//success1 = true，result1 为 ‚12345‛

charresult2

boolsuccess2

success2= StringDecAsc2Bin("32768", result2)

//success2 = true，但结果超出 result2 所能表达的范围

charsrc3[2] = "4b"

charresult3

boolsuccess3

success3= StringDecAsc2Bin (src3[0], result3)

//success3 = false，因 src3 包含 ‘0’ ~ ‘9’ 以外的字符

endmacro_command

7. StringBin2DecAsc

语法 success = StringBin2DecAsc (source,destination[start])

此函数将整数转换成十进制字符串。

来源 source 可以为常数或变量。

destination‛start‛ 必须为一维字符数组变量，用以存放转换后的十进制字符串。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

若转换后的十进制字符串长度大于目标数组的大小，函数将会回传 false。

success 字段可写可不写。

例如：

macro_commandmain()

int src1= 2147483647

chardest1[20]

boolsuccess1

success1= StringBin2DecAsc(src1, dest1[0])

//success1 = true，dest1为 ‚2147483647‛

shortsrc2 = 0x3c

chardest2[20]

boolsuccess2

success2= StringBin2DecAsc(src2, dest2[0])

//success2 = true，dest2为 ‚60‛

int src3= 2147483647

chardest3[5]

boolsuccess3

success3= StringBin2DecAsc(src3, dest3[0])

//success3 = false，dest3 内容不变

endmacro_command

8. StringDecAsc2Float

语法 success = StringDecAsc2Float (source[start],destination)

或 success =StringDecAsc2Float (‚source‛, destination)

此函数将十进制字符串转换成浮点数。

来源字符串 source 可以为静态字符串 (如 ‚source‛ )或是一维字符数组变量

(如 source[start] )。

destination 必须为一变量，用以存放转换后的浮点数值。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

来源字符串必需为十进制字符串，若其包含 ‘0’ ~ ‘9’ 或 ‘.’ 以外的字符，

函数将会回传 false。

success 字段可写可不写。

macro_commandmain()

charsrc1[10] = "12.345"

floatresult1

boolsuccess1

success1= StringDecAsc2Float(src1[0], result1)

//success1 = true，result1 为 ‚12.345‛

floatresult2

boolsuccess2

success2= StringDecAsc2Float("1.234567890", result2)

//success2 = true，但结果超出 result2 所能表达的范围，可能丧失精确度

charsrc3[2] = "4b"

floatresult3

boolsuccess3

success3= StringDecAsc2Float(src3[0], result3)

//success3 = false，因 src3 包含 ‘0’ ~ ‘9’或 ‘.’ 以外的字符

endmacro_command

9. StringFloat2DecAsc

语法 success = StringFloat2DecAsc(source,destination[start])

此函数将浮点数转换成十进制字符串。

来源 source 可以为常数或变量。

Destination[start] 必须为一维字符数组变量，用以存放转换后的十进制字符串。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

若转换后的十进制字符串长度大于目标数组的大小，函数将会回传 false。

success 字段可写可不写。

例如：

macro_command main()

float src1 = 1.2345

char dest1[20]

bool success1

success1 = StringFloat2DecAsc(src1, dest1[0])

// success1 = true，dest1为 ‚1.2345‛

float src2 = 1.23456789

char dest2 [20]

bool success2

success2 = StringFloat2DecAsc(src2, dest2 [0])

// success2 = true，但可能丧失精确度

float src3 = 1.2345

char dest3[5]

bool success3

success3 = StringFloat2DecAsc(src3, dest3 [0])

// success3 = false，dest3 内容不变

end macro_command

10. StringHexAsc2Bin

语法 success = StringHexAsc2Bin (source[start],destination)

或 success =StringHexAsc2Bin (‚source‛, destination)

此函数将十六进制字符串转换成整数。

来源字符串 source 可以为静态字符串 (如 ‚source‛ )或是一维字符数组变量

(如 source‛start‛)。

destination 必须为一变量，用以存放转换后的整数值。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

来源字符串必需为十六进制字符串，若其包含 ‘0’ ~ ‘9’ 或 ‘a’ ~ ‘f’ 或

‘A’ ~ ‘F’ 以外的字符，函数将会回传 false。

success 字段可写可不写。

例如：

macro_command main()

char src1[5]="0x3c"

int result1

bool success1

success1 = StringHexAsc2Bin(src1[0], result1)

// success1 = true，result1 为 3c

short result2

bool success2

success2 = StringDecAsc2Bin("1a2b3c4d", result2)

// success2 = true，但结果超出 result2 所能表达的范围，result2 =3c4d

char src3[2] = "4g"

char result3

bool success3

success3 = StringDecAsc2Bin (src3[0], result3)

// success3=false，因 src3包含 ‘0’ ~ ‘9’ 或 ‘a’ ~ ‘f’ 或 ‘A’ ~ ‘F’

以外的字符

end macro_command

11. StringBin2HexAsc

语法 success = StringBin2HexAsc (source,destination[start])

此函数将整数转换成十六进制字符串。

来源source可以为常数或变量。

Destination[start] 必须为一维字符数组变量，用以存放转换后的十六进制字符串。

执行完毕会回传一 bool 类型的值给 success 字段。当转换成功，success等于

true，否则等于 false。

若转换后的十六进制字符串长度大于目标数组的大小，函数将会回传 false。

success 字段可写可不写。

例如：

macro_commandmain()

int src1= 20

chardest1[20]

boolsuccess1

success1= StringBin2HexAsc(src1, dest1[0])

//success1 = true，dest1 为 ‚14‛

shortsrc2 = 0x3c

chardest2[20]

bool success2

success2= StringBin2HexAsc(src2, dest2[0])

//success2 = true，dest2 为 ‚3c‛

int src3= 0x1a2b3c4d

chardest3[6]

boolsuccess3

success3= StringBin2HexAsc(src3, dest3[0])

//success3 = false，dest3 内容不变

endmacro_command

12. StringMid

语法 success = StringMid (source[start], count,destination[start])

或 success = StringMid(‚string‛, start, count, destination[start])

利用此函数可将一个字符串中的某一段子字符串提取出来。

来源字符串 source 可以为静态字符串 (如 ‚source‛)或是一维字符数组变量

(如 source[start])。当来源字符串为字符数组变量时，由数组下标决定子字符串起

始位置。当来源字符串为静态字符串时，由第二个参数 start 决定子字符串起始

位置。

count 决定要提取的子字符串长度。

Destination[start] 必须为一维字符数组变量，用以存放提取出来的子字符串。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。

若提取出来的子字符串长度大于目标数组的大小，函数将会回传false。

success 字段可写可不写。

例如：

macro_commandmain()

charsrc1[20] = "abcdefghijklmnopqrst"

chardest1[20]

boolsuccess1

success1= StringMid(src1[5], 6, dest1[0])

//success1 = true，dest1 为 ‚fghijk‛

charsrc2[20] = "abcdefghijklmnopqrst"

chardest2[5]

boolsuccess2

success2= StringMid(src2[5], 6, dest2[0])

//success2 = false，dest2 内容不变

chardest3[20] = "12345678901234567890"

boolsuccess3

success3= StringMid("abcdefghijklmnopqrst", 5, 5, dest3[15])

//success3 = true，dest3 = ‚123456789012345fghij‛

endmacro_command

13. StringLength

length =StringLength (source[start])

或 length =StringLength ([source])

取得字符串的长度。

来源字符串 source 可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如 source[start])。

函数回传值代表来源字符串的长度。

例如：

macro_commandmain()

charsrc1[20] = "abcde"

intlength1

length1=StringLength(src1[0])

//length1 = 5

charsrc2[20] = { 'a', 'b' , 'c' , 'd' , 'e' }

intlength2

length2=StringLength(src2[0])

//length2 = 20

charsrc3[20] = "abcdefghij"

intlength3

length3= StringLength(src3 [2])

//length3 = 8

end macro_command

14. StringCat

语法 success = StringCat (source[start],destination[start])

或 success = StringCat(‚source‛, destination[start])

利用此函数将来源字符串衔接于目标字符串之后。此函数执行成功后，目标字符

串将等于两字符串衔接后的结果。

来源字符串source可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如source[start])。

Destination[start]必须为一维字符数组变量。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当两字符串衔接后的长度超过目标数组的长度时，目标字

符串将保留衔接以前的内容，不做任何改变，并回传 false。

例如：macro_commandmain()

charsrc1[20] = "abcdefghij"

chardest1[20] = "1234567890"

boolsuccess1

success1=StringCat(src1[0], dest1[0])

//success1 = true，dest1 = "123456790abcdefghij"

chardest2 [10] = "1234567890"

boolsuccess2

success2=StringCat("abcde", dest2 ‚0‛)

//success2 = false，dest2 内容不变

charsrc3[20] = "abcdefghij"

chardest3[20]

boolsuccess3

success3= StringCat(src3[0], dest3[15])

//success3 = false，dest3内容不变

endmacro_command

15. StringCompare

语法 ret = StringCompare (str1[start],str2[start])

ret =StringCompare (‚string1‛, str2[start])

ret =StringCompare (str1[start], ‚string2‛)

ret =StringCompare (‚string1‛, ‚string2‛)

比较两字符串的内容是否相等。此函数将大小写视为不同。

两个传入的字符串皆可以为静态字符串 (如 ‚source‛)或是一维字符数组变量

(如 source[start])。

执行完毕会回传一 bool类型的值给 ret 字段。若两字符串相等，ret 为 true，否

则为 false。

例如：

macro_commandmain()

chara1[20] = "abcde"

charb1[20] = "ABCDE"

boolret1

ret1 =StringCompare(a1[0], b1[0])

// ret1= false

chara2[20] = "abcde"

charb2[20] = "abcde"

boolret2

ret2 =StringCompare(a2[0], b2[0])

// ret2= true

char a3[20] = "abcde"

charb3[20] = "abcdefg"

boolret3

ret3 =StringCompare(a3‛0‛, b3‛0‛)

// ret3= false

endmacro_command

16. StringCompareNoCase

语法 ret = StringCompareNoCase(str1[start],str2[start])

ret =StringCompareNoCase(‚string1‛, str2[start])

ret =StringCompareNoCase(str1[start], ‚string2‛)

ret =StringCompareNoCase(‚string1‛, ‚string2‛)

比较两字符串的内容是否相等。此函数将大小写视为相同。

两个传入的字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如 source[start])。

执行完毕会回传一 bool 类型的值给 ret 字段。若两字符串相等，ret 为 true，

否则为 false。

例如：

macro_commandmain()

chara1[20] = "abcde"

charb1[20] = "ABCDE"

boolret1

ret1 =StringCompareNoCase(a1[0], b1[0])

// ret1= true

chara2[20] = "abcde"

charb2[20] = "abcde"

boolret2

ret2 =StringCompareNoCase(a2[0], b2[0])

// ret2= true

char a3[20] = "abcde"

charb3[20] = "abcdefg"

boolret3

ret3 =StringCompareNoCase(a3[0], b3[0])

// ret3= false

endmacro_command

17. StringFind

语法 position = StringFind (source[start],target[start])

position= StringFind (‚source‛, target[start])

position= StringFind (source[start], ‚target‛)

position= StringFind (‚source‛, ‚target‛)

寻找某一字符串 (target) 在另一个字符串 (source) 里第一次出现的位置。

两个传入的字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如 source[start])。

执行完毕会回传target字符串在 source 字符串里出现的位置。Source 字符串由 0

开始递增为字符编索引值。若 source 字符串存在一个子字符串，其所包含的字符

与排列顺序跟 target 字符串完全相等，则函数会回传此子字符串开头的索引值，

若没有找到，则回传 -1。

例如：

macro_commandmain()

charsrc1[20] = "abcde"

chartarget1[20] = "cd"

short pos1

pos1 =StringFind(src1[0], target1[0])

// pos1= 2

chartarget2[20] = "ce"

shortpos2

pos2 =StringFind( "abcde", target2‛0‛)

// pos2= -1

charsrc3[20] = "abcde"

shortpos3

pos3 =StringFind(src3[3], "cd")

// pos3= -1

endmacro_command

18. StringReverseFind

语法 position = StringReverseFind (source[start],target[start])

position= StringReverseFind (‚source‛, target[start])

position= StringReverseFind (source[start], ‚target‛)

position= StringReverseFind (‚source‛, ‚target‚)

寻找某一字符串 (target) 在另一个字符串 (source) 里最后一次出现的位置。

两个传入的字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如 source[start])。

执行完毕会回传 target 字符串在 source 字符串里最后一次出现的位置。source

字符串由 0 开始递增为字符编索引值。若 source 字符串存在一个子字符串，其

所包含的字符与排列顺序跟 target 字符串完全相等，则函数会回传此子字符串开

头的索引值，若没有找到，则回传 -1。若 source 字符串中存在多个与 target字

符串相等的子字符串，则回传最后一个出现的子字符串的位置。

例如：

macro_commandmain()

charsrc1[20] = "abcdeabcde"

chartarget1[20] = "cd"

shortpos1

pos1 =StringReverseFind(src1[0], target1[0])

// pos1= 7

chartarget2[20] = "ce"

shortpos2

pos2 =StringReverseFind( "abcdeabcde" , target2[0])

// pos2= -1

charsrc3[20] = "abcdeabcde"

shortpos3

pos3 =StringReverseFind(src3[6], "ab")

// pos3= -1

endmacro_command

9.StringFindOneOf

语法 position = StringFindOneOf (source[start],target[start])

position= StringFindOneOf (‚source‛, target[start])

position= StringFindOneOf (source[start], ‚target‛)

position= StringFindOneOf (‚source‛, ‚target‛)

寻找 target 字符串中任一个字符在 source 字符串中第一次出现的位置。

两个传入的字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量

(如 source[start])。

执行完毕会回传 target 字符串中任一个字符在 source 字符串里第一次出现的位

置，即 source 字符串中为该字符编的索引值 (由 0 开始)。若没有找到，则回传

-1。

例如：

macro_commandmain()

charsrc1[20] = "abcdeabcde"

chartarget1[20] = "sdf"

shortpos1

pos1 =StringFindOneOf(src1[0], target1[0])

// pos1= 3

charsrc2[20] = "abcdeabcde"

shortpos2

pos2 =StringFindOneOf(src2[1], "agi")

// pos2= 4

chartarget3 [20] = "bus"

shortpos3

pos3 =StringFindOneOf("abcdeabcde", target3[1])

// pos3= -1

endmacro_command

19. StringIncluding

语法 success = StringIncluding (source[start],set[start], destination[start])

success= StringIncluding (‚source‛, set[start], destination[start])

success= StringIncluding (source[start], ‚set‛, destination[start])

success= StringIncluding (‚source‛, ‚set‛, destination[start])

提取 source 字符串中某个以索引值 0 的字符 (第一个字符) 开头的子字符串，

而且此子字符串的每个字符都能在 set 字符串中找到相同的字符。此函数将会从

source 字符串的第一个字符开始寻找，直到找到不存在于 set 字符串中的字符为

止。

source 字符串与 set 字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符

数组变量 (如 source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当提取出来的字符串长度大于目标数组的大小，将会回传

false。

例如：

macro_commandmain()

charsrc1[20] = "cabbageabc"

charset1[20] = "abc"

chardest1[20]

boolsuccess1

success1= StringIncluding(src1[0], set1[0], dest1[0])

// success1= true，dest1 = “cabba”

charsrc2[20] = "gecabba"

chardest2[20]

boolsuccess2

success2= StringIncluding(src2[0], "abc", dest2[0])

//success2 = true，dest2 = ‚ “”

charset3[20] = "abc"

chardest3[4]

boolsuccess3

success3= StringIncluding("cabbage", set3[0], dest3[0])

//success3 = false，dest3内容不变

endmacro_command

20. StringExcluding

语法 success = StringExcluding (source[start],set[start], destination[start])

success= StringExcluding (‚source‛, set[start], destination[start])

success= StringExcluding (source[start], ‚set‛, destination[start])

success= StringExcluding (‚source‛, ‚set‛, destination[start])

提取 source 字符串中某个以索引值 0 的字符 (第一个字符) 开头的子字符串，

而且此子字符串的每个字符必不存在于set字符串中。此函数将会从 source字符串

的第一个字符开始寻找，直到找到存在于 set 字符串中的字符为止。

source 字符串与 set 字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符

数组变量 (如 source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当提取出来的字符串长度大于目标数组的大小，将会回传

false。

例如：

macro_commandmain()

charsrc1[20] = "cabbageabc"

charset1[20] = "ge"

chardest1[20]

boolsuccess1

success1= StringExcluding(src1[0], set1[0], dest1[0])

//success1 = true，dest1 = "cabba"

charsrc2[20] = "cabbage"

chardest2[20]

boolsuccess2

success2= StringExcluding(src2[0], "abc", dest2[0])

//success2 = true，dest2 =" "

charset3[20] = "ge"

chardest3[4]

boolsuccess3

success3= StringExcluding("cabbage", set3[0], dest3[0])

//success3 = false，dest3 内容不变

endmacro_command

21. StringToUpper

语法 success = StringToUpper (source[start],destination[start])

success= StringToUpper (‚source‛, destination[start])

将 source 字符串的字符全部转换成大写，并写入 destination 字符串。

source 字符串可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量 (如

source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。source 字符串长度大于目标数组的大小，将会回传 false。

例如：

macro_commandmain()

charsrc1[20] = "aBcDe"

chardest1[20]

boolsuccess1

success1= StringToUpper(src1[0], dest1[0])

//success1 = true，dest1 = ‚ABCDE‛

char dest2[4]

boolsuccess2

success2= StringToUpper("aBcDe", dest2[0])

//success2 = false，dest2 内容不变

endmacro_command

22. StringToLower

语法 success = StringToLower (source[start],destination[start])

success= StringToLower (‚source‛, destination[start])

将 source 字符串的字符全部转换成小写，并写入 destination 字符串。

source 字符串可以为静态字符串 (如 ‚source‛)或是一维字符数组变量 (如

source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。source 字符串长度大于目标数组的大小，将会回传 false。

例如：

macro_commandmain()

charsrc1[20] = "aBcDe"

chardest1[20]

boolsuccess1

success1= StringToUpper(src1[0], dest1[0])

//success1 = true，dest1 = ‚abcde‛

chardest2[4]

boolsuccess2

success2= StringToUpper("aBcDe", dest2[0])

//success2 = false，dest2 内容不变

endmacro_command

23. StringToReverse

语法 success = StringToReverse (source[start],destination[start])

success= StringToReverse (‚source‛, destination[start])

例如：

将 source 字符串反转，并写入 destination 字符串。

source 字符串可以为静态字符串 (如 ‚source‛) 或是一维字符数组变量 (如

source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。source 字符串长度大于目标数组的大小，将会回传 false。

例如：

macro_commandmain()

charsrc1[20] = "abcde"

chardest1[20]

boolsuccess1

success1= StringToUpper(src1[0], dest1[0])

//success1 = true，dest1 = “edcba”

chardest2[4]

boolsuccess2

success2= StringToUpper("abcde", dest2[0])

//success2 = false，dest2 内容不变

endmacro_command

24. StringTrimLeft

语法 success = StringTrimLeft (source[start],set[start], destination[start])

success= StringTrimLeft (‚source‛, set[start], destination[start])

success= StringTrimLeft (source[start], ‚set‛, destination[start])

success= StringTrimLeft (‚source‛, ‚set‛, destination[start]) 从 source 字符串的第一个字符开始往后寻找，若找到与 set 字符串相同的字符

便裁剪掉该字符，直到遇到不存在于 set 字符串中的字符为止。

source 字符串与 set 字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符

数组变量 (如 source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当裁剪完后的字符串长度大于目标数组的大小，将会回传

false。

例如：

macro_commandmain()

charsrc1[20] = "# *a*#bc"

charset1[20] = "# *"

chardest1[20]

boolsuccess1

success1= StringTrimLeft (src1[0], set1[0], dest1[0])

//success1 = true，dest1 = "a*#bc"

charset2[20] = {'#', ' ', '*'}

chardest2[4]

success2= StringTrimLeft ("# *a*#bc", set2[0], dest2[0])

//success2 = false，dest2 内容不变

charsrc3[20] = "abc *#"

chardest3[20]

boolsuccess3

success3= StringTrimLeft (src3[0], "# *", dest3[0])

//success3 = true，dest3 = "abc *#"

endmacro_command

25. StringTrimRight

语法 success = StringTrimRight (source[start],set[start], destination[start])

success= StringTrimRight (‚source‛, set[start], destination[start])

success= StringTrimRight (source[start], ‚set‛, destination[start])

success= StringTrimRight (‚source‛, ‚set‛, destination[start])

从 source 字符串的最后一个字符开始往前寻找，若找到与 set 字符串相同的字

符便裁剪掉该字符，直到遇到不存在于 set 字符串中的字符为止。

source 字符串与 set 字符串皆可以为静态字符串 (如 ‚source‛) 或是一维字符

数组变量 (如 source[start])。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当裁剪完后的字符串长度大于目标数组的大小，将会回传

false。

例如：

macro_commandmain()

charsrc1[20] = "# *a*#bc# * "

charset1[20] = "# *"

chardest1[20]

boolsuccess1

success1= StringTrimRight(src1[0], set1[0], dest1[0])

//success1 = true，dest1= ‚# *a*#bc‛

charset2[20] = {'#', ' ', '*'}

chardest2[20]

success2= StringTrimRight("# *a*#bc", set2[0], dest2[0])

//success2 = true，dest2 = ‚# *a*#bc‛

charsrc3[20] = "ab**c *#"

chardest3[4]

boolsuccess3

success3= StringTrimRight(src3[0], "# *", dest3[0])

//success3 = false，dest3 内容不变

endmacro_command

26. StringInsert

语法 success = StringInsert (pos, insert[start],destination[start])

success= StringInsert (pos, ‚insert‛, destination[start])

success= StringInsert (pos, insert[start], length, destination[start])

success= StringInsert (pos, ‚insert‛, length, destination[start])

将 insert 字符串插入到目标字符串中的特定位置，插入位置由 pos 所指定。

Insert 字符串可以为静态字符串 (如 ‚insert‛) 或是一维字符数组变量 (如

insert[start])。

用户亦可以在 length 字段指定 insert 字符串的长度。

执行完毕会回传一 bool 类型的值给 success 字段。当执行成功，success等于

true，否则等于 false。当插入完成后的字符串长度大于目标数组的大小，将会回

传 false。

例如：

macro_commandmain()

charstr1[20] = "but the question is"

charstr2[10] = ", that is"

chardest[40] = "to be or not to be"

boolsuccess

success= StringInsert(18, str1[3], 13, dest[0])

//success = true, dest = "to be or not to be the question"

success= StringInsert(18, str2[0], dest[0])

//success=true, dest="to be or not to be, that is the question"

success= StringInsert(0, "Hamlet:", dest[0])

//success = false, dest 内容不变

endmacro_command

欢迎光临工控编程吧 (https://www.gkbc8.com/)