昆仑通态脚本开发函数.docx
- 文档编号:1817738
- 上传时间:2023-05-01
- 格式:DOCX
- 页数:55
- 大小:26.17KB
昆仑通态脚本开发函数.docx
《昆仑通态脚本开发函数.docx》由会员分享,可在线阅读,更多相关《昆仑通态脚本开发函数.docx(55页珍藏版)》请在冰点文库上搜索。
昆仑通态脚本开发函数
函数意义:
得到当前触发单通道写的通道号;
返回值:
整型。
-1失败,>0通道号;
参数:
无;
实例:
!
GetCurrentChannelNum()。
!
SetIntChannelValueByName(DataStr,n)
函数意义:
根据通道的名称对通道进行设置,假设该通道类型为整型(开关型)变量;
返回值:
整型。
-1失败,0成功。
参数:
DataStr,字符型,需要设置的通道名称的字符串。
n,整型,需要设定的整型值
实例:
!
SetIntChannelValueByName("发电机启动",1)。
实例说明:
将通道“发电机启动”的值设为1;
!
SetSingleChannelValueByName(DataStr,x)
函数意义:
根据通道的名称对通道进行设置,假设该通道类型为单精度浮点型(数值型)变量;
返回值:
整型。
-1失败,0成功。
参数:
DataStr,字符型,需要设置的通道名称的字符串。
n,单精度浮点型,需要设定的值
实例:
!
SetSingleChannelValueByName("温度",。
实例说明:
将通道“温度”的值设为;
!
SetIntChannelValueByNum(DataNum,n)
函数意义:
根据通道的编号对通道进行设置,假设该通道类型为整型(开关型)变量;
返回值:
整型。
-1失败,0成功。
参数:
DataNum,整型,需要设置的通道编号,从1开始。
n,整型,需要设定的整型值
实例:
!
SetIntChannelValueByNum(3,1)。
实例说明:
将通道3的值设为1;
!
SetSingleChannelValueByNum(DataNum,x)
函数意义:
根据通道的编号对通道进行设置,假设通道为单精度浮点型(数值型)变量;
返回值:
整型。
-1失败,0成功。
参数:
DataNum,整型,需要设置的通道编号,从1开始。
x,单精度数值型,需要设定的数值
实例:
!
SetSingleDataValueByNum(2,。
实例说明:
将通道2的值设为。
!
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的个数表示需要格式化出的小数
位数。
小数点前的0为一个时,表示小数点前根据实际数值显示。
当小数点前没有0时,表示
为.xx式样,当小数点前的0不止一个时,使用0来填充不够的位数。
实例:
!
Format,"")="";!
Format,".00")=".24";
!
Format,"")=""。
!
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=""。
!
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,=""。 ! Trim(str) 函数意义: 把字符型数据对象str中左右两端的空格剔除。 返回值: 字符型。 参数: str,字符型。 实例: ! Trim("dsfk")="dsfk"。 ! Ucase(str) 函数意义: 把字符型数据对象str的所有字符转换成大写。 返回值: 字符型。 参数: str,字符型。 实例: ! UCase("sedERT")="SEDERT"。 ! Val(str) 函数意义: 把字符型数据对象str的值转换成数值。 返回值: 数值型。 参数: str,字符型。 实例: ! Val("")=。 ! Sscanf(str1,str2,任意) 函数意义: 根据给出的字符串按一定的格式读取其值到变量中。 返回值: -1失败,0成功。 参数: str1,字符串型,需要转化为数值的字符串。 str2,字符串型,转化格式。 任意,任意个需要转化出来的变量值 实例: ! Sscanf("123,","%d,%f",int1,value1),则int1=123value1=。 ! Sscanf("%","%%%f",value),则value=。 说明: 这里转化格式支持两种%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)=。 ! Cos(x) 函数意义: 余弦函数。 返回值: 数值型。 参数: x,数值型,用弧度表示。 实例: ! Cos=。 ! Sin(x) 函数意义: 正弦函数。 返回值: 数值型。 参数: x,数值型,用弧度表示。 实例: ! Sin=。 ! Tan(x) 函数意义: 正切函数。 返回值: 数值型。 参数: x,数值型,用弧度表示。 实例: ! Tan=。 ! Exp(x) 函数意义: 指数函数。 返回值: 数值型。 参数: x,数值型。 实例: ! Exp=。 ! Log(x) 函数意义: 对数函数。 返回值: 数值型。 参数: x,数值型。 实例: ! Log(10)=。 ! Sqr(x) 函数意义: 平方根函数。 返回值: 数值型。 参数: x,数值型。 实例: ! Sqr=。 ! Abs(x) 函数意义: 绝对值函数。 返回值: 数值型。 参数: x,数值型。 实例: ! Abs=。 ! Sgn(x) 函数意义: 符号函数。 返回值: 数值型。 参数: x,数值型。 实例: ! Sgn(-10)=-1;! Sgn(10)=1;! Sgn(0)=0。 ! Rand(x,y) 函数意义: 生成随机数,随机数的范围在x和y之间。 返回值: 数值型。 参数: x,数值型。 Y,数值型。 实例: ! Rand(3,4)=。 ! 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,整型,时间值。 实例: ! TimeGetSpan(iTime1,iTime2) 实例说明: 计算两个时间iTime1和iTime2之差。 ! TimeGetDayOfWeek(iTime) 函数意义: 获取时间值iTime中的星期。 返回值: 整型,时间值iTime中的秒数(1为星期日,2表示星期一,……)。 参数: iTime,整型,时间值。 实例: ! TimeGetDayOfWeek(iTime)。 实例说明: 获取时间值iTime中的星期。 ! TimeGetHou
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 昆仑通态 脚本 开发 函数