昆仑通态脚本开发函数

!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，单精度数值型，需要设定的数值

实例：!SetSingleDataV alueByNum(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来填充不够的位数。

实例：!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)