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

!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来填充不够的位数。实 例：!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 str2， 返回值为-1 时则 str1 0，写入的字符数；参 数：参数1，字符型，写入的字符串。实 例：! DevWriteStr（ABCDE）。实例说明：向父设备写入字符串”ABCDE”。!DevReadStr(ByRef 参数1,参数2,参数3)函数意义：从父设备读取一定长度的字符串。返 回 值：整型。 -1：串口不正常； -2：读超时，未读入一个字符； 0，读的字符数；参 数：参数1，传址型，字符型，接收的字符串， 参数2，整型，需接收的字符数，接收到足够多的字符则返回； 参数3，整型，等待的时间，如果超过时间尚未读到足够的字符也返回，如果为0则直接返回。实 例：! DevReadStr（str,20,500）。实例说明：从父设备读取字符串，如果在500毫秒内已读到20个字符，则返回， 如果超过500毫秒未读取到20个字符，超时返回。!DevReadStrByFind(ByRef 参数1,参数2,参数3)函数意义：从父设备读取字符串，直到读到某字符串。返 回 值：整型。 -1：串口不正常； -2：读超时，未读入一个字符； 0，读的字符数；参 数：参数1，传址型，字符型，接收的字