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

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

《昆仑通态脚本开发函数.docx》由会员分享，可在线阅读，更多相关《昆仑通态脚本开发函数.docx（43页珍藏版）》请在冰豆网上搜索。

昆仑通态脚本开发函数

!

GetCurrentChannelNum（）函数意义：

得到当前触发单通道写的通道号；返回值：

整型。

-1失败，>0通道号；参数：

无；

实例：

!

GetCurrentChannelNum（）。

!

SetIntChannelValueByName（DataStr,n）函数意义：

根据通道的名称对通道进行设置，假设该通道类型为整型（开关型）变量；返回值：

整型。

-1失败，0成功。

参数：

DataStr，字符型，需要设置的通道名称的字符串。

n，整型，需要设定的整型值

发电机启动",1）

例：

!

SetIntChannelValueByName（"

实例说明：

将通道“发电机启动”的值设为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中最左边的空格剔除。

返回值：

字符型。

实例：

!

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',intl,valuel），则inti=123valuel=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值。

!

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：

S）转换为时间值。

返回值：

整型转换后的时间值。

参数：

strTime字符型以字符串型表示的时间（YYYY/MM/DDHH:

MM:

S）S。

实例：

!

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（i