昆仑通态脚本开发函数.docx

1、昆仑通态脚本开发函数!GetCurrentChannelNum() 函数意义：得到当前触发单通道写的通道号； 返 回 值：整型。 -1 失败， 0 通道号； 参 数：无；实 例： !GetCurrentChannelNum() 。!SetIntChannelValueByName(DataStr,n) 函数意义：根据通道的名称对通道进行设置，假设该通道类型为整型(开关型)变量； 返 回 值：整型。 -1 失败， 0 成功。参 数： DataStr ，字符型，需要设置的通道名称的字符串。n ，整型，需要设定的整型值发电机启动 ,1)例： ! SetIntChannelValueByName (实

2、例说明：将通道“发电机启动”的值设为 1； !SetSingleChannelValueByName(DataStr,x)函数意义： 根据通道的名称对通道进行设置， 假设该通道类型为单精度浮点型(数值型)变 量；返 回 值：整型。 -1 失败， 0 成功。参 数： DataStr ，字符型，需要设置的通道名称的字符串。n ，单精度浮点型，需要设定的值实 例： ! SetSingleChannelValueByName ( 温度 ,45.5) 。实例说明：将通道“温度”的值设为 45.5 ；!SetIntChannelValueByNum(DataNum,n) 函数意义：根据通道的编号对通道进行

3、设置，假设该通道类型为整型(开关型)变量； 返 回 值：整型。 -1 失败， 0 成功。参 数：DataNum整型，需要设置的通道编号，从 1开始。n ，整型，需要设定的整型值实 例： ! SetIntChannelValueByNum(3,1) 。 实例说明：将通道 3 的值设为 1；!SetSingleChannelValueByNum(DataNum,x) 函数意义：根据通道的编号对通道进行设置，假设通道为单精度浮点型(数值型)变量； 返 回 值：整型。 -1 失败， 0 成功。参 数：DataNum整型，需要设置的通道编号，从 1开始。x ，单精度数值型，需要设定的数值实 例： !Se

4、tSingleDataValueByNum(2,45.5) 。实例说明：将通道 2的值设为 45.5 。!GetIntChannelValueByName(DataStr,ByRef n) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为整型(开关型)变量； 返 回 值：整型。 -1 失败， 0 成功。参 数： DataStr ，字符型，需要读取的通道名的字符串。n ，引用型，整型，保存读出值的变量； 实 例： ! GetIntChannelValueByName ( 发电机启动 ,n) 。 实例说明：将通道“显示容”的值读出，赋给变量 n；!GetSingleChannelValue

5、ByName(DataStr,ByRef x) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为单精度浮点型(开关型)变 量； 返 回 值：整型。 -1 失败， 0 成功。参 数： DataStr ，字符型，需要读取的通道名的字符串。x ，引用型，单精度浮点型，保存读出值的变量； 实 例： ! GetSingleChannelValueByName ( 温度 ,x) 。 实例说明：将通道“温度”的值读出，赋给变量 x；!GetIntChannelValueByNum(DataNum,ByRef n) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为整型(开关型)变量； 返 回

6、值：整型。 -1 失败， 0 成功。参 数：DataNum整型，需要读取的通道的编号。n ，引用型，整型，保存读出值的变量； 实 例： ! GetIntChannelValueByNum (1,n) 。实例说明：将通道 1 的值读出，赋给变量 n；!GetSingleChannelValueByNum(DataNum,ByRef x) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为单精度浮点型(开关型)变 量； 返 回 值：整型。 -1 失败， 0 成功。参 数：DataNum整型，需要读取的通道的编号。x ，引用型，单精度浮点型，保存读出值的变量； 实 例： ! GetSingle

7、ChannelValueByNum (2,x) 。实例说明：将通道 2 的值读出，赋给变量 x；!GetChannelCount() 函数意义：得到驱动的通道总数； 返 回 值：整型。 -1 失败， = 0 通道总数； 参 数：无；实 例： ! GetChannelCount () 。!Trace(Str)函数意义： 在脚本驱动开发工具的调试功能中， 在输出框输出一些信息， 在运行环境下不起 作用；返 回 值：整型。 -1 失败， 0 成功；参 数： str ，字符型，输出字符串；实 例： !Trace(!strFormat(%D,123) 。!Sleep(n) 函数意义：在脚本执行的过程中，

8、暂停一段时间。返 回 值：整型。 -1 失败， 0 成功；参 数：n,整型，暂停时间，以毫秒( ms)为单位;实 例： !Sleep(500) 。实例说明：暂停执行 500 毫秒;!Ascii2I(str) 函数意义：返回字符串 str 的首字符的 Ascii 值。 返 回 值：整型。参 数： str , 字符型。实 例： !Ascii2I(Afd) =65 。!Bin2I(str) 函数意义：把二进制字符串转换为数值。 返 回 值：整型。参 数： str , 字符型。实 例： !Bin2I(101) =5 。!Format(x , str) 函数意义：格式化数值型数据对象。 返 回 值：字符

9、型。参 数： 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 进制字符串转换为数值。 返 回 值：整型。参 数：

10、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 ，整

11、型。实 例： !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 的所有字符转换成小写。 返 回 值：字

12、符型。参 数： 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 中最左边的空格剔除

13、。 返 回 值：字符型。实 例： !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 右

14、边起，取 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

15、 是否相等，返回值为 0 时相等，返回值为 1 时则 str1 str2 ，返回值为 -1 时则 str1 str2 ，返回值为 -1 时则 str1 str2 。此函数不区分字母大小写。返 回 值：整型。参数： str1 ， 字符型；str2， 字符型。实例：！StrCompCase(ABC,abc) = 0，！StrCompCase(BBC,abc) = -1!StrFormat(FormatStr, 任意个数变量 ) 函数意义：格式化字符串，可以格式化任意多个数值。 返 回 值：字符型。参 数： FormatStr ， 字符型，格式化字符串。后面的参数可以任意多个。 实 例： !StrF

16、ormat(%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) =

17、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,以及支持在格式字符串中用 %匹配源字符串的

18、 %。!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 的

19、功能一致，为了与 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的字符串。返 回 值：字符型。

20、参 数： 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,

21、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 ，字符型，被搜索的字符

22、串；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 ， 查询的起始位置，字符

23、串的首位置为 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) 函数意义：正弦函数。

24、 返 回 值：数值型。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

25、!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整

26、型，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 位

27、清空。!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

28、开始。 返 回 值：整型。参 数： m 整型。 n, 整型。实 例： !BitLShift(&H03,1) = &H06 !BitRShift(m,n)函数意义：右移 位的计算从 0 开始。 返 回 值：整型。参 数： m 整型。 n, 整型。实 例： !BitRShift(&H03,1) = &H01 !TimeStr2I(strTime)函数意义：将表示时间的字符串( YYYY/MM/DD HH:MM：S)转换为时间值。 返 回 值：整型 转换后的时间值。参 数： strTime 字符型 以字符串型表示的时间( YYYY/MM/DD HH:MM:S)S。实 例： !TimeStr2I(20

29、01/1/1 3:15:28) 。实例说明：将表示时间的字符串“ 2001/1/1 3: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 中的月份( 112)。 参 数： iTime ，整型，时间值。实 例： !TimeGetMonth (i