昆仑通态脚本开发函数

!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，单精度数值型，需要设定的数值实例：!SetSingleDataV alueByNum(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。