昆仑通态脚本开发函数.docx
《昆仑通态脚本开发函数.docx》由会员分享，可在线阅读，更多相关《昆仑通态脚本开发函数.docx（56页珍藏版）》请在冰豆网上搜索。
昆仑通态脚本开发函数
函数意义：
得到当前触发单通道写的通道号；
返回值：
整型。
-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,ByRefn）
函数意义：
根据通道的名字，将该通道的值读出，假设该通道为整型（开关型）变量；
返回值：
整型。
-1失败，0成功。
参数：
DataStr，字符型，需要读取的通道名的字符串。
n，引用型，整型，保存读出值的变量；
实例：
!
GetIntChannelValueByName（"发电机启动",n）。
实例说明：
将通道“显示内容”的值读出，赋给变量n；
!
GetSingleChannelValueByName（DataStr,ByRefx）
函数意义：
根据通道的名字，将该通道的值读出，假设该通道为单精度浮点型（开关型）变量；
返回值：
整型。
-1失败，0成功。
参数：
DataStr，字符型，需要读取的通道名的字符串。
x，引用型，单精度浮点型，保存读出值的变量；
实例：
!
GetSingleChannelValueByName（"温度",x）。
实例说明：
将通道“温度”的值读出，赋给变量x；
!
GetIntChannelValueByNum（DataNum,ByRefn）
函数意义：
根据通道的编号，将该通道的值读出，假设该通道为整型（开关型）变量；
返回值：
整型。
-1失败，0成功。
参数：
DataNum，整型，需要读取的通道的编号。
n，引用型，整型，保存读出值的变量；
实例：
!
GetIntChannelValueByNum（1,n）。
实例说明：
将通道1的值读出，赋给变量n；
!
GetSingleChannelValueByNum（DataNum,ByRefx）
函数意义：
根据通道的编号，将该通道的值读出，假设该通道为单精度浮点型（开关型）变量；
返回值：
整型。
-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此函数区分字母大小写。
返回值：
整型。
参数：
str1，字符型；
str2，字符型。
实例：
!
StrComp（"ABC","abc"）=1。
!
StrCompCase（str1,str2）
函数意义：
比较字符型数据对象str1和str2是否相等，返回值为0时相等，返回值为1时则str1>str2，
返回值为-1时则str1此函数不区分字母大小写。
返回值：
整型。
参数：
str1，字符型；
str2，字符型。
实例：
!
StrCompCase（"ABC","abc"）=0，!
StrCompCase（"BBC","abc"）=-1。
!
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",int1,value1），则int1=123value1=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值。
返回值：
整型。
参数：
s，字符型。
实例：
!
Asc（"Afd"）=65。
说明：
与Ascii2I的功能一致，为了与VB的语法保持一致；
!
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。
如果字符型数据对象str的长度已超过n，则只保留左边长度为n的字符串。
返回值：
字符型。
参数：
str，字符型，源字符串；
chr,字符型，后缀字符；
n，整型，新字符串的长度；
实例：
!
Postfix（"FA","0",4）="FA00"。
!
Postfix（"FA","AB",8）="FAABABAB"。
!
Postfix（"11FA","0",2）="11"。
!
InStrRev（n,str1,str2）
函数意义：
查找一字符串str2在另一字符串str1中第一次出现的位置，字符串的首位置为1，
本函数与Instr函数的区别为，它是从字符串的尾部开始进行查找。
字符串的首位置为1。
返回值：
整型，如果找到，则返回位置，如果未找到，则返回-1。
参数：
n，整型，开始搜索的位置，该位置是从字符串的首位置开始计算的，字符串的首位置为1，
如果值为0，则表示从最后一个字符开始；
str1，字符型，被搜索的字符串；
str2，字符型，要搜索的子字符串。
实例：
!
InStrRev（0,"sdlkfjsd","sd"）=7；!
InStrRev（3,"sdlkfjsd","sd"）=1。
!
Replace（expression,find,replace,start,count）
函数意义：
将字符串expression中的字符串find替换为字符串replace，字符串的首位置为1。
返回值：
字符型，返回被替换后的结果字符串。
参数：
expression，字符型，源字符串；
find，字符型，需替代的字符串；
replace，字符型，替代的字符串；
start，查询的起始位置，字符串的首位置为1；
count,替换次数，-1表示将所有的可能字符串全部替换，1表示只替换第一个发现的字符串。
实例：
!
Replace（"sdlkfjsd","sd","A",1,-1）="AlkfjA"；!
Replace（"sdlkfjsd","sd","A",3,-1）="sdlkfjA"。
!
Atn（x）
函数意义：
反正切函数。
返回值：
数值型，用弧度表示。
参数：
x，数值型。
实例：
!
Atn
（1）=0.785398。
!
Cos（x）
函数意义：
余弦函数。
返回值：
数值型。
参数：
x，数值型，用弧度表示。
实例：
!
Cos（3.14159）=-1.0。
!
Sin（x）
函数意义：
正弦函数。
返回值：
数值型。
参数：
x，数值型，用弧度表示。
实例：
!
Sin（3.14159）=0.0。
!
Tan（x）
函数意义：
正切函数。
返回值：
数值型。
参数：
x，数值型，用弧度表示。
实例：
!
Tan（3.14159）=0.0。
!
Exp（x）
函数意义：
指数函数。
返回值：
数值型。
参数：
x，数值型。
实例：
!
Exp（2.3020585093）=10.0。
!
Log（x）
函数意义：
对数函数。
返回值：
数值型。
参数：
x，数值型。
实例：
!
Log（10）=2.302。
!
Sqr（x）
函数意义：
平方根函数。
返回值：
数值型。
参数：
x，数值型。
实例：
!
Sqr（4.0）=2.0。
!
Abs（x）
函数意义：
绝对值函数。
返回值：
数值型。
参数：
x，数值型。
实例：
!
Abs（-3.14159）=3.14159。
!
Sgn（x）
函数意义：
符号函数。
返回值：
数值型。
参数：
x，数值型。
实例：
!
Sgn（-10）=-1；!
Sgn（10）=1；!
Sgn（0）=0。
!
Rand（x,y）
函数意义：
生成随机数，随机数的范围在x和y之间。
返回值：
数值型。
参数：
x，数值型。
Y,数值型。
实例：
!
Rand（3,4）=3.1。
!
BitAnd（m,n）
函数意义：
按位与，位的计算从0开始。
返回值：
整型。
参数：
m，整型，n，整型。
实例：
!
BitAnd（&H03,&H04）=&H00。
!
BitOr（m,n）
函数意义：
按位或，位的计算从0开始。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitOr（&H03,&H04）=&H07。
!
BitXor（m,n）
函数意义：
按位异或，位的计算从0开始。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitXor（&H03,&H04）=&H07。
!
BitClear（m,n）
函数意义：
清除m的指定n位为0，位置从0开始计算。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitClear（&H03,1）=1，把第2位清空。
!
BitSet（m,n）
函数意义：
设置m的指定位为1，位置从0开始计算。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitSet（&H03,2）=&H07。
!
BitNot（m）
函数意义：
按位取反。
位的计算从0开始。
返回值：
整型。
参数：
m，整型。
实例：
!
BitNot（&H00）=&HFFFF。
!
BitTest（m,n）
函数意义：
检测指定位是否为1，位置从0开始计算。
返回值：
整型，如果为1，则返回1，否则返回0。
参数：
m，整型。
n,整型。
实例：
!
BitTest（3,2）=0。
!
BitLShift（m,n）
函数意义：
左移，位的计算从0开始。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitLShift（&H03,1）=&H06。
!
BitRShift（m,n）
函数意义：
右移，位的计算从0开始。
返回值：
整型。
参数：
m，整型。
n,整型。
实例：
!
BitRShift（&H03,1）=&H01。
!
TimeStr2I（strTime）
函数意义：
将表示时间的字符串（YYYY/MM/DDHH:
MM:
SS）转换为时间值。
返回值：
整型，转换后的时间值。
参数：
strTime，字符型，以字符串型表示的时间（YYYY/MM/DDHH:
MM:
SS）。
实例：
!
TimeStr2I（"2001/1/13:
15:
28"）。
实例说明：
将表示时间的字符串“2001/1/13:
15:
28”转换为整型的时间值。
!
TimeI2Str（iTime,strFormat）
函数意义：
将时间值转换为字符串表示的时间。
返回值：
字符型，转换后的时间字符串。
参数：
iTime，整型，时间值（注意，这里只能用!
TimeStr2I（strTime）转换出的时间值，否则将不能正确转换。
）；
strFormat，字符型，转换后的时间字符串的格式。
实例：
!
TimeI2Str（Time,"%Y/%m/%D%H:
%M:
%S"）。
实例说明：
将时间值转换为字符串型，其表示格式为：
星期，月 日，年。
!
TimeGetYear（iTime）
函数意义：
获取时间值iTime中的年份。
返回值：
整型，时间值iTime中的年份。
参数：
iTime，整型，时间值。
实例：
!
TimeGetYear（iTime）。
实例说明：
获取时间值iTime中的年份。
!
TimeGetMonth（iTime）
函数意义：
获取时间值iTime中的月份。
返回值：
整型，时间值iTime中的月份（1~12）。
参数：
iTime，整型，时间值。
实例：
!
TimeGetMonth（iTime）。
实例说明：
获取时间值iTime中的月份。
!
TimeGetSecond（iTime）
函数意义：
获取时间值iTime中的秒数。
返回值：
整型，时间值iTime中的秒数（0~59）。
参数：
iTime，整型，时间值。
实例：
!
TimeGetSecond（iTime）。
实例说明：
获取时间值iTime中的秒数。
!
TimeGetSpan（iTime1,iTime2）
函数意义：
计算两个时间iTime1和iTime2之差。
返回值：
整型，两时间之差。
参数：
iTime1，整型，时间值；
iTime2，整型，时间值。
升级会员 