昆仑通态脚本开发函数

更新时间：2024-04-07 09:03:01 阅读量：综合文库文档下载

说明：文章内容仅供预览，部分内容可能不全。下载后的文档，内容与下面显示的完全一致。下载之前请确认下面内容是否您想要的，是否完整无缺。

!GetCurrentChannelNum()

函数意义：得到当前触发单通道写的通道号；返回值：整型。-1 失败，> 0 通道号；参数：无；

实例：!GetCurrentChannelNum()。

!SetIntChannelValueByName(DataStr,n)

函数意义：根据通道的名称对通道进行设置，假设该通道类型为整型（开关型）变量；返回值：整型。-1 失败，0 成功。

参数：DataStr，字符型，需要设置的通道名称的字符串。 n，整型，需要设定的整型值

实例：! SetIntChannelValueByName (\发电机启动\。实例说明：将通道“发电机启动”的值设为1；

!SetSingleChannelValueByName(DataStr,x)

函数意义：根据通道的名称对通道进行设置，假设该通道类型为单精度浮点型（数值型）变量；

返回值：整型。-1 失败，0 成功。

参数：DataStr，字符型，需要设置的通道名称的字符串。 n，单精度浮点型，需要设定的值

实例：! SetSingleChannelValueByName (\温度\。实例说明：将通道“温度”的值设为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；

!GetSingleChannelValueByName(DataStr,ByRef x)

函数意义：根据通道的名字，将该通道的值读出，假设该通道为单精度浮点型（开关型）变量；

返回值：整型。-1 失败，0 成功。

参数：DataStr，字符型，需要读取的通道名的字符串。 x，引用型，单精度浮点型，保存读出值的变量；实例：! GetSingleChannelValueByName (\温度\。实例说明：将通道“温度”的值读出，赋给变量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(\。

!Sleep(n)

函数意义：在脚本执行的过程中，暂停一段时间。返回值：整型。-1 失败， 0 成功；

参数：n，整型，暂停时间，以毫秒（ms）为单位；实例：!Sleep(500)。

实例说明：暂停执行500毫秒；

!Ascii2I(str)

函数意义：返回字符串str的首字符的Ascii值。返回值：整型。

参数：str，字符型。

实例：!Ascii2I(\。

!Bin2I(str)

函数意义：把二进制字符串转换为数值。返回值：整型。

参数：str，字符型。实例：!Bin2I(\。

!Format(x，str)

函数意义：格式化数值型数据对象。返回值：字符型。

参数：x，数值型，要格式化的数值； str，字符型，格式化数值的格式。表示为0.00样式。小数点后的0的个数表示需要格式化出的小数

位数。小数点前的0为一个时，表示小数点前根据实际数值显示。当小数点前没有0时，表示

为.xx式样，当小数点前的0不止一个时，使用0来填充不够的位数。

实例：!Format(1.236,\；!Format(1.236,\； !Format(1.236,\。

!Hex2I(str)

函数意义：把16进制字符串转换为数值。返回值：整型。

参数：str，字符型。

实例：!Hex2I (\。

!I2Ascii(n)

函数意义：返回指定Ascii值的字符。返回值：字符型。参数：n，整型。

实例：!I2Ascii(65) =\。

!I2Bin(n)

函数意义：把数值转换为二进制字符串。返回值：字符型。参数：n，整型。

实例：!I2Bin (5) =\

!I2Hex(n)

函数意义：把数值转换为16进制字符串。返回值：字符型。参数：n，整型。

实例：!I2Hex (17) =\。

!I2Oct(n)

函数意义：把数值转换为8进制字符串。返回值：字符型。参数：n，整型。

实例：!I2Oct (9) =\。

!InStr(n,str1,str2) 函数意义：查找一字符串str2在另一字符串str1中第一次出现的位置，字符串的首位置为1。返回值：整型，如果找到，则返回位置，如果未找到，则返回0。参数：n，整型，开始搜索的位置，字符串的首位置为1； str1，字符型，被搜索的字符串； str2，字符型，要搜索的子字符串。

实例：!InStr(1,\；!InStr(3,\。

!Lcase(str)

函数意义：把字符型数据对象str的所有字符转换成小写。返回值：字符型。

参数：str，字符型。

实例：!LCase(\。

!Left(str,n)

函数意义：字符型数据对象str左边起，取n个字符。返回值：字符型。

参数：str：字符型，源字符串；n，整型，取字符个数。实例：!Left(\ =\

!Len(str)

函数意义：求字符型数据对象str的字符串长度（字符个数）。返回值：浮点数。

参数：str，字符型。

实例：!Len(\；!Len(\昆仑通态\。