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

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

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

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

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

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

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

7、参 数：无；实 例：! GetChannelCount ()。!Trace(Str)函数意义：在脚本驱动开发工具的调试功能中，在输出框输出一些信息，在运行环境下不起作用；返 回 值：整型。-1 失败， 0 成功；参 数：str，字符型，输出字符串；实 例：!Trace(!strFormat(%D,123)。!Sleep(n) 函数意义：在脚本执行的过程中，暂停一段时间。返 回 值：整型。-1 失败， 0 成功；参 数：n，整型，暂停时间，以毫秒ms为单位；实 例：!Sleep(500)。实例说明：暂停执行500毫秒； !Ascii2I(str)函数意义：返回字符串str的首字符的Ascii值。

8、返 回 值：整型。参 数：str， 字符型。实 例：!Ascii2I(Afd) =65。!Bin2I(str)函数意义：把二进制字符串转换为数值。返 回 值：整型。参 数：str， 字符型。实 例：!Bin2I(101) =5。!Format(x，str)函数意义：格式化数值型数据对象。返 回 值：字符型。参 数：x， 数值型，要格式化的数值； str， 字符型，格式化数值的格式。表示为0.00样式。小数点后的0的个数表示需要格式化出的小数 位数。小数点前的0为一个时，表示小数点前根据实际数值显示。当小数点前没有0时，表示 为.xx式样，当小数点前的0不止一个时，使用0来填充不够的位数。实 例

9、：!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)函数

10、意义：把数值转换为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,sdlkf

11、jwe,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(ABCDEF

12、G) = 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， 字符型。实 例：!Oc

13、t2I (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)函数意义：比

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

15、!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(str

16、1, str2, 任意)函数意义：根据给出的字符串按一定的格式读取其值到变量中。返 回 值：-1 失败， 0 成功。参 数：str1，字符串型，需要转化为数值的字符串。 str2，字符串型，转化格式。任意，任意个需要转化出来的变量值实 例：!Sscanf(123,45.23, %d,%f,int1, value1)，那么 int1 = 123 value1 = 45.23。 !Sscanf(%-123.234 , %f,value), 那么 value = -123.234。说明：这里转化格式支持两种 %f 和 %d，以与支持在格式字符串中用 % 匹配源字符串的 %。!Space(n)函数意义

17、：由多个空格形成长度为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) 函数意义：返回字符

18、串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，那么只保存右边长

19、度为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， 整型，新字符串的长度；

20、实 例：!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，

21、字符型，被搜索的字符串； 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， 查询的起始位置，字符串的首

22、位置为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，数值型

23、，用弧度表示。实 例：!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)函数意义：绝对值函数。返 回 值：数值型。

24、参 数：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)函数意义：按

25、位或，位的计算从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,

26、整型。实 例：!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

27、(m,n)函数意义：右移，位的计算从0开场。返 回 值：整型。参 数：m，整型。n,整型。实 例：!BitRShift(&H03,1) = &H01。!TimeStr2I(strTime)函数意义：将表示时间的字符串YYYY/MM/DD HH:MM:SS转换为时间值。返 回 值：整型，转换后的时间值。参 数：strTime，字符型，以字符串型表示的时间YYYY/MM/DD HH:MM:SS。实 例：!TimeStr2I(2001/1/1 3:15:28)。实例说明：将表示时间的字符串“2001/1/1 3:15:28转换为整型的时间值。!TimeI2Str(iTime,strFormat)函数

28、意义：将时间值转换为字符串表示的时间。返 回 值：字符型，转换后的时间字符串。参 数：iTime，整型，时间值注意，这里只能用 !TimeStr2I(strTime)转换出的时间值，否那么将不能正确转换。； strFormat，字符型，转换后的时间字符串的格式。实 例：!TimeI2Str(Time,%Y/%m/%D %H:%M:%S)。实例说明：将时间值转换为字符串型，其表示格式为：星期，月日，年。!TimeGetYear(iTime)函数意义：获取时间值iTime中的年份。返 回 值：整型，时间值iTime中的年份。参 数：iTime，整型，时间值。实 例：!TimeGetYear(iTi

29、me)。实例说明：获取时间值iTime中的年份。!TimeGetMonth(iTime)函数意义：获取时间值iTime中的月份。返 回 值：整型，时间值iTime中的月份112。参 数：iTime，整型，时间值。实 例：!TimeGetMonth (iTime)。实例说明：获取时间值iTime中的月份。!TimeGetSecond(iTime)函数意义：获取时间值iTime中的秒数。返 回 值：整型，时间值iTime中的秒数059。参 数：iTime，整型，时间值。实 例：!TimeGetSecond (iTime)。实例说明：获取时间值iTime中的秒数。!TimeGetSpan(iTime1,iTime2)函数意义：计算两个时间iTime1和iTime2之差。返 回 值：整型，两时间之差。参 数：iTime1，整型，时间值；