当前位置:文档之家› 昆仑通态脚本开发函数

昆仑通态脚本开发函数

!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。

相关主题