昆仑通态脚本开发函数
!GetCurrentChannelNum() 函数意义：得到当前触发单通道写的通道号；返回值：整型。-1 失败，> 0 通道号；参数：无；
实例：!GetCurrentChannelNum() 。
!SetIntChannelValueByName(DataStr,n) 函数意义：根据通道的名称对通道进行设置，假设该通道类型为整型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataStr ，字符型，需要设置的通道名称的字符串。
n ，整型，需要设定的整型值
例：! SetIntChannelValueByName ("
发电机启动",1)
实例说明：将通道“发电机启动”的值设为1；!SetSingleChannelValueByName(DataStr,x)
函数意义：根据通道的名称对通道进行设置，假设该通道类型为单精度浮点型(数值型)变量；
返回值：整型。-1 失败，0 成功。
参数：DataStr ，字符型，需要设置的通道名称的字符串。
n ，单精度浮点型，需要设定的值
实例：! SetSingleChannelValueByName (" 温度",45.5) 。
实例说明：将通道“温度”的值设为45.5 ；
!SetIntChannelValueByNum(DataNum,n) 函数意义：根据通道的编号对通道进行设置，假设该通道类型为整型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataNum整型，需要设置的通道编号，从1开始。
n ，整型，需要设定的整型值
实例：! SetIntChannelValueByNum(3,1) 。实例说明：将通道 3 的值设为1；
!SetSingleChannelValueByNum(DataNum,x) 函数意义：根据通道的编号对通道进行设置，假设通道为单精度浮点型(数值型)变量；返回值：整型。-1 失败，0 成功。
参数：DataNum整型，需要设置的通道编号，从1开始。
x ，单精度数值型，需要设定的数值
实例：!SetSingleDataValueByNum(2,45.5) 。
实例说明：将通道2的值设为45.5 。
!GetIntChannelValueByName(DataStr,ByRef n) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为整型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataStr ，字符型，需要读取的通道名的字符串。
n ，引用型，整型，保存读出值的变量；实例：! GetIntChannelValueByName (" 发电机启动",n) 。实例说明：将通道“显示容”的值读出，赋给变量n；
!GetSingleChannelValueByName(DataStr,ByRef x) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为单精度浮点型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataStr ，字符型，需要读取的通道名的字符串。
x ，引用型，单精度浮点型，保存读出值的变量；实例：! GetSingleChannelValueByName (" 温度",x) 。实例说明：将通道“温度”的值读出，赋给变量x；
!GetIntChannelValueByNum(DataNum,ByRef n) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为整型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataNum整型，需要读取的通道的编号。
n ，引用型，整型，保存读出值的变量；实例：! GetIntChannelValueByNum (1,n) 。
实例说明：将通道 1 的值读出，赋给变量n；
!GetSingleChannelValueByNum(DataNum,ByRef x) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为单精度浮点型(开关型)变量；返回值：整型。-1 失败，0 成功。
参数：DataNum整型，需要读取的通道的编号。
x ，引用型，单精度浮点型，保存读出值的变量；实例：! GetSingleChannelValueByNum (2,x) 。
实例说明：将通道 2 的值读出，赋给变量x；
!GetChannelCount() 函数意义：得到驱动的通道总数；返回值：整型。-1 失败，>= 0 通道总数；参数：无；
实例：! GetChannelCount () 。
!Trace(Str)
函数意义：在脚本驱动开发工具的调试功能中，在输出框输出一些信息，在运行环境下不起作用；返回值：整型。-1 失败，0 成功；
参数：str ，字符型，输出字符串；
实例：!Trace(!strFormat("%D",123)) 。
!Sleep(n) 函数意义：在脚本执行的过程中，暂停一段时间。
返回值：整型。-1 失败，0 成功；
参数：n,整型，暂停时间，以毫秒( ms)为单位;
实例：!Sleep(500) 。
实例说明：暂停执行500 毫秒;
!Ascii2I(str) 函数意义：返回字符串str 的首字符的Ascii 值。返回值：整型。
参数：str , 字符型。
实例：!Ascii2I("Afd") =65 。
!Bin2I(str) 函数意义：把二进制字符串转换为数值。返回值：整型。
参数：str , 字符型。
实例：!Bin2I("101") =5 。
!Format(x , str) 函数意义：格式化数值型数据对象。返回值：字符型。
参数：x , 数值型,要格式化的数值;
str , 字符型,格式化数值的格式。表示为0.00 样式。小数点后的0 的个数表示需要格式化出的小数
位数。小数点前的0 为一个时, 表示小数点前根据实际数值显示。当小数点前没有0 时,表示
为.xx 式样,当小数点前的0 不止一个时,使用0 来填充不够的位数。
实例：!Format(1.236,"0.00") = "1.24" ; !Format(1.236,".00") = ".24" ;
!Format(1.236,"00.00") = "01.24" 。
!Hex2I(str)
函数意义：把16 进制字符串转换为数值。返回值：整型。
参数：str , 字符型。
实例：!Hex2I ("1A") =26 。
!I2Ascii(n)
函数意义：返回指定Ascii 值的字符。返回值：字符型。
参数：n, 整型。
实例：!I2Ascii(65) ="A" 。
!I2Bin(n) 函数意义：把数值转换为二进制字符串。
返回值：字符型。
参数：n ，整型。
实例：!I2Bin (5) ="101"
!I2Hex(n)
函数意义：把数值转换为16 进制字符串。返回值：字符型。
参数：n ，整型。
实例：!I2Hex (17) ="11" 。
!I2Oct(n)
函数意义：把数值转换为8 进制字符串。返回值：字符型。
参数：n ，整型。
实例：!I2Oct (9) ="11" 。
!InStr(n,str1,str2)
函数意义：查找一字符串str2 在另一字符串str1 中第一次出现的位置，字符串的首位置为1。
返回值：整型，如果找到，则返回位置，如果未找到，则返回0。
参数：n,整型，开始搜索的位置，字符串的首位置为1;
str1 ，字符型，被搜索的字符串；
str2 ,字符型,要搜索的子字符串。
实例：!InStr(1,"sdlkfjwe","sd") = 1 ；!InStr(3,"sdlkfjwe","sd") = 0 。
!Lcase(str) 函数意义：把字符型数据对象str 的所有字符转换成小写。返回值：字符型。
参数：str , 字符型。
实例：!LCase("sedERT") = "sedert" 。
!Left(str,n) 函数意义：字符型数据对象str 左边起,取n 个字符。
返回值：字符型。
参数：str :字符型，源字符串；n,整型，取字符个数。实例：!Left("ABCDEFG",2) ="AB" !Len(str)
函数意义：求字符型数据对象str 的字符串长度(字符个数) 返回值：浮点数。参数：str , 字符型。
实例：!Len("ABCDEFG") = 7 ；!Len(" 昆仑通态") = 8
!Ltrim(str)
函数意义：把字符型数据对象str 中最左边的空格剔除。返回值：字符型。
str ，字符型。
实例：!LTrim(" dsfk ") = "dsfk " !Mid(str,n,k)
函数意义：从字符型数据对象str 左边第n 个字符起，取k 个字符。字符首位置从1 开始算起。返回值：字符型。
参数：str ，字符型，源字符串；
n ，整型，起始位置；
k ，整型，取字符数。
实例：!Mid("ABCDEFG",3,2) = "CD" 。
!Oct2I(str)
函数意义：把8 进制字符串转换为数值。返回值：整型。
参数：str ，字符型。
实例：!Oct2I ("11") =9 。
!Right(str,n) 函数意义：从字符型数据对象str 右边起，取n 个字符。返回值：字符型。
参数：str ，字符型，源字符串；n ，整型，取字符个数。实例：!Right("ABCDEFG",2) ="FG" 。
!Rtrim(str)
函数意义：把字符型数据对象str 中最右边的空格剔除。
返回值：字符型。
参数：str ，字符型。
实例：!LTrim(" dsfk ") =" dsfk" 。
!Str(x)
函数意义：将数值型数据对象x 的值转换成字符串。
返回值：字符型。
参数：x ，数值型。
实例：!Str(0.712) ="0.712" 。
!StrComp(str1,str2)
函数意义：比较字符型数据对象str1 和str2 是否相等，返回值为0 时相等，返回值为 1 时则str1 > str2 ，
返回值为-1 时则str1 < str2 。此函数区分字母大小写。
返回值：整型。
参数：str1 ，字符型；str2 ，字符型。
实例：!StrComp("ABC","abc") = 1 !StrCompCase(str1,str2)
函数意义：比较字符型数据对象str1 和str2 是否相等，返回值为0 时相等，返回值为 1 时则str1 > str2 ，
返回值为-1 时则str1 < str2 。此函数不区分字母大小写。
返回值：整型。
参数：str1 ，字符型；
str2，字符型。
实例：！StrCompCase("ABC","abc") = 0，！StrCompCase("BBC","abc") =
!StrFormat(FormatStr, 任意个数变量) 函数意义：格式化字符串，可以格式化任意多个数值。返回值：字符型。
参数：FormatStr ，字符型，格式化字符串。后面的参数可以任意多个。实例：!StrFormat("%g--%g",12,12.34)= "12--12.34" 。
!Trim(str)
函数意义：把字符型数据对象str 中左右两端的空格剔除。返回值：字符型。
参数：str ，字符型。
实例：!Trim(" dsfk ") ="dsfk" 。
!Ucase(str)
函数意义：把字符型数据对象str 的所有字符转换成大写。返回值：字符型。
参数：str ，字符型。
实例：!UCase("sedERT") ="SEDERT" 。
!Val(str) 函数意义：把字符型数据对象str 的值转换成数值。返回值：数值型。
参数：str ，字符型。
实例：!Val("0.712") = 0.712 。
!Sscanf(str1, str2, 任意) 函数意义：根据给出的字符串按一定的格式读取其值到变量中。
返回值：-1 失败，0 成功。
参数：str1 ，字符串型，需要转化为数值的字符串。
str2 ，字符串型，转化格式。任意，任意个需要转化出来的变量值
实例：！Sscanf("123,45.23", "%d,%f',intl, valuel)，则inti = 123 valuel = 45.23。
!Sscanf("%-123.234" , "%%%f",value), 则value = -123.234 。
说明：这里转化格式支持两种
%f 和％d ,以及支持在格式字符串中用 %%匹配源字符串
的 %。
!Space(n) 函数意义：由多个空格形成长度为 n 的新字符串 返 回 值：字符型。
参 数： n ， 整型，形成的新字符串长度； 实 例： !Space(3) = " " 。
!Strings(chr,n)
函数意义：由多个 chr 形成长度为 n 的新字符串 返 回 值：字符型。
参
数： chr ， 字符型，源字符串； n ， 整型，形成的新字符串长度； 实 例： !Strings("A",3) = "AAA" 。
!Strings(" 中 ",4) = " 中中 " 。
!Chr(n)
函数意义：返回指定 Ascii 值的字符。 返 回 值： 字符型。
参 数： n , 整型。 实
例： !Chr(65) ="A" 。
说 明： 与 I2Ascii 的功能一 致，为了与 VB 的语法保持 !Asc(s)
函数意义：返回字符串 s 的首字母的 Ascii 值。
!MidEx(str,n)
函数意义：从字符型数据对象 str 左边第 n 个字符起，右边所有的字符。数字字符时，从 1 开始算起。 返 回 值：字符型。
参 数： str ， 字符型，源字符串；
n ， 整型，起始位置；
实 例： !MidEx("ABCDEFG",3) = "CDEFG" 。
!Prifix(str,chr,n) 函数意义：使字符型数据对象 str 左边增加前缀字符 chr ，使得新字符串的长度为 n 。
如果字符型数据对象 str 的长度已超过n ,则只保留右边长度为
n 的 字符串。
返 回 值：字符型。
参 数： str ， 字符型，源字符串； chr, 字符型，前缀字符； n ， 整型，新字符串的长度；
实 例： !Prifix("FA","0",4) = "00FA" !Prifix("FA","AB",8) = "ABABABFA" !Prifix("11FA","0",2) = "FA" !Postfix(str,chr,n) 函数意义：使字符型数据对象 str 右边增加后缀字符 chr ，使得新字符串的长度为
n 。 返 回 值： 整型。
参 数： s , 字符型。 实
例： !Asc ("Afd") =65 。 说 明： 与 Ascii2I 的功能一 ，为了与 VB 的语法保持一致；