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

本文格式为Word版，下载可任意编辑昆仑通态脚本开发函数 !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(\昆仑通态\ !Ltrim(str) 函数意义：把字符型数据对象str中最左边的空格剔除 返 回 值：字符型 参 数：str， 字符型 实 例：!LTrim(\ dsfk \ \ !Mid(str,n,k) 函数意义：从字符型数据对象str左边第n个字符起，取k个字符字符首位置从1开头算起 返 回 值：字符型 参 数：str， 字符型，源字符串； n， 整型，起始位置； k， 整型，取字符数 实 例：!Mid(\ !Oct2I(str) 函数意义：把8进制字符串转换为数值 返 回 值：整型 参 数：str， 字符型 实 例：!Oct2I (\ !Right(str,n) 函数意义：从字符型数据对象str右边起，取n个字符 返 回 值：字符型 参 数：str，字符型，源字符串；n，整型，取字符个数 实 例：!Right(\ =\ !Rtrim(str) 函数意义：把字符型数据对象str中最右边的空格剔除。

返 回 值：字符型 参 数：str， 字符型 实 例：!LTrim(\ dsfk \ dsfk\ !Str(x) 函数意义：将数值型数据对象x的值转换成字符串 返 回 值：字符型 参 数：x， 数值型 实 例：!Str(0.712) =\ !StrComp(str1,str2) 函数意义：对比字符型数据对象str1和str2是否相等，返回值为0时相等，返回值为1时那么str1 > str2， 返回值为-1 时那么 str1 < str2此函数区分字母大小写 返 回 值：整型 参 数：str1， 字符型； — 9 —。