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

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

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

昆仑通态脚本开发函数资料

!

GetCurrentChannelNum（）

函数意义：

得到当前触发单通道写的通道号；

返回值：

整型。

-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"。