昆仑通态脚本开发函数

!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,ByRef n) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为整型(开关型)变量；返回值：整型。-1 失败，0 成功。

参数：DataStr ，字符型，需要读取的通道名的字符串。

n ，引用型，整型，保存读出值的变量；实例：! GetIntChannelValueByName (" 发电机启动",n) 。实例说明：将通道“显示容”的值读出，赋给变量n；

!GetSingleChannelValueByName(DataStr,ByRef x) 函数意义：根据通道的名字，将该通道的值读出，假设该通道为单精度浮点型(开关型)变量；返回值：整型。-1 失败，0 成功。

参数：DataStr ，字符型，需要读取的通道名的字符串。

x ，引用型，单精度浮点型，保存读出值的变量；实例：! GetSingleChannelValueByName (" 温度",x) 。实例说明：将通道“温度”的值读出，赋给变量x；

!GetIntChannelValueByNum(DataNum,ByRef n) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为整型(开关型)变量；返回值：整型。-1 失败，0 成功。

参数：DataNum整型，需要读取的通道的编号。

n ，引用型，整型，保存读出值的变量；实例：! GetIntChannelValueByNum (1,n) 。

实例说明：将通道 1 的值读出，赋给变量n；

!GetSingleChannelValueByNum(DataNum,ByRef x) 函数意义：根据通道的编号，将该通道的值读出，假设该通道为单精度浮点型(开关型)变量；返回值：整型。-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 来填充不够的位数。