昆仑通态脚本开发函数 下载本文

实例说明:向端口&H188输出字节&HAAFF。

!OutpD(参数1,参数2)

函数意义:向端口输出四个字节。

返 回 值:整型。返回值=0:调用正常,-1:调用不正常。 参 数:参数1,整型,端口号; 参数2,长整型,输出的字节。

实 例:!OutpD(&H188,&H0000AAFF)。

实例说明:向端口&H188输出字节&H0000AAFF。

!Inp(参数1)

函数意义:返回从端口输入的一个字节。 返 回 值:字节型。输入的字节。 参 数:参数1,整型,端口号。 实 例:!Inp(&H188)。

实例说明:返回从端口&H188输入的一个字节。

!InpW(参数1)

函数意义:返回从端口输入的两个字节。 返 回 值:整型。输入的字节。 参 数:参数1,整型,端口号。 实 例:!InpW(&H188)。

实例说明:从端口&H188输入的两个字节。

!InpD(参数1)

函数意义:返回从端口输入的四个字节。 返 回 值:长整型。输入的字节。 参 数:参数1,整型,端口号。 实 例:!InpD(&H188)。

实例说明:返回从端口&H188输入的四个字节。

!SetIntDataValueByName(DataStr,n) 函数意义:根据实时数据变量的名字对变量进行设置,假设该实时数据变量为整型(开关型)变量;

返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要设置的变量名的字符串。 n,整型,需要设定的整型值

实 例:!SetIntDataValueByName(\发电机启动\。

实例说明:将实时数据变量“发电机启动”的值设为1;该函数一般用于设备命令的处理过程中。

!SetSingleDataValueByName(DataStr,x) 函数意义:根据实时数据变量的名字对变量进行设置,假设该实时数据变量为单精度浮点型(数值型)变量;

返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要设置的变量名的字符串。 x,单精度数值型,需要设定的数值

实 例:!SetSingleDataValueByName(\温度\。 实例说明:将实时数据变量“温度”的值设为45.5;该函数一般用于设备命令的处理过程中。

!SetStrDataValueByName(DataStr,str)

函数意义:根据实时数据变量的名字对变量进行设置,假设该实时数据变量为字符型变量; 返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要设置的变量名的字符串。 str,字符型,需要设定的值

实 例:!SetStrDataValueByName(\显示内容\通讯正常\。 实例说明:将实时数据变量“显示内容”的值设为”通讯正常”; 该函数一般用于设备命令的处理过程中。

!GetIntDataValueByName(DataStr,ByRef n) 函数意义:根据实时数据变量的名字,将该变量的值读出,假设该实时数据变量为整型变量; 返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要读取的变量名的字符串。 n,引用型,整型,保存读出值的变量;

实 例:! GetIntDataValueByName (\发电机启动\。

实例说明:将实时数据变量“显示内容”的值读出,赋给变量n;该函数一般用于设备命令的处理过程中。

!GetSingleDataValueByName(DataStr,ByRef x)

函数意义:根据实时数据变量的名字,将该变量的值读出,假设该实时数据变量为单精度浮点型变量;

返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要读取的变量名的字符串。 x,引用型,单精度浮点型,保存读出值的变量; 实 例:! GetSingleDataValueByName (\温度\。

实例说明:将实时数据变量“温度”的值读出,赋给变量x;该函数一般用于设备命令的处理过程中。

!GetStrDataValueByName(ArrName,str)

函数意义:根据实时数据变量的名字,将该变量的值读出,假设该实时数据变量为字符型变量;

返 回 值:整型。-1 失败,0 成功。

参 数:DataStr,字符型,需要读取的变量名的字符串。 str,引用型,字符型,保存读出值的变量; 实 例:! GetIntDataValueByName (\显示内容\。

实例说明:将实时数据变量“显示内容”的值读出,赋给变量str;该函数一般用于设备命令的处理过程中。

!ArrayResize(ArrName, n)

函数意义:重新设置数组的大小。 返 回 值:整型。-1 失败,0 成功。 参 数:ArName,数组名称。 n,整型,需要设置的数组大小; 实 例:! ArrayResize(bArr, 10)。

实例说明:将数组bArr的大小设定为10。

!ArrayAppend(ArrName1, ArrName2)

函数意义:把一个字节数组追加到另外一个数组的后面。要求两个数组类型一致。数组长度变为两数组长度之和。 返 回 值:-1 失败; >=0 追加之后新数组的大小。

参 数:ArrName1,数组名称1,追加内容后生成的数组。 ArrName2,数组名称2,追加到另外一个数组后面的内容。 实 例:! ArrayAppend(ArrA, Arrb)。

实例说明:将数组ArrB的内容追加到数组ArrA之后,ArrA数组的长度变为ArrA与ArrB两个数组长度之和。

!ArrayCopy(ArrDes, ArrSrc)

函数意义:把一个数组复制到另外一个数组。两者必须是同一类型,把源数组的内容复制到目标数组中去。

目标数组的大小也更源数组一致。 返 回 值:-1 失败,0 成功

参 数:ArrDes,数组名称,复制生成的数组,该数组原内容和大小将会被新设置覆盖。 ArrSrc,数组名称,复制生成数组的源内容,新生成数组内容跟它一致。 实 例:! ArrayCopy(ArrDes, ArrSrc)。

实例说明:根据数组ArrSrc 的内容,复制出一个同样的数组 ArrDes。

!ArrayGetSize(Arr)

函数意义:求数组的长度。

返 回 值:-1 失败, >=0 数组的长度。 参 数:Arr ,数组名称,求长度的数组。 实 例:! ArrayGetSize(Arr)。 实例说明:求数组Arr的长度。

!ArrayIntAdd(Arr, n)

函数意义:在一个整型数组后面添加一个整数元素,数组长度加1。 返 回 值:-1 失败, 0 成功。

参 数:Arr ,数组名称,需要增加整数元素的整数数组。 n, 整数,需要添加的整数元素。 实 例:! ArrayIntAdd(Arr, 5)。

实例说明:在数组Arr的末尾增加一个数值为5的元素,Arr数组长度增加1。

!ArraySingleAdd(Arr, x)

函数意义:给一个浮点数组添加一个浮点数元素,数组长度加1。 返 回 值:-1 失败, 0 成功。

参 数:Arr ,数组名称,需要增加浮点数元素的浮点数组。 x,浮点数,添加的浮点数。

实 例:! ArraySingleAdd(Arr, 5.1234)。

实例说明:在浮点数组Arr的末尾增加一个数值为5.1234的元素,Arr数组长度增加1。

!ArrayByteAdd(Arr, b)

函数意义:给一个字节数组添加一个字节元素,数组长度加1。 返 回 值:-1 失败, 0 成功。

参 数:Arr ,数组名称,需要添加字节元素的字节数组。 b,字节,添加的字节元素。 实 例:! ArrayByteAdd(Arr, b)。

实例说明:在字节数组Arr的末尾增加一个字节 b,Arr数组长度增加1。

!ArrayStringAdd(Arr, str)

函数意义:给一个字符串数组添加字符串元素,数组长度加1。 返 回 值:-1 失败, 0 成功。

参 数:Arr ,数组名称,需要添加元素的字符串数组。 b,字符串,添加到数组的字符串。 实 例:! ArrayStringAdd(Arr, str)。

实例说明:在字节数组Arr的末尾增加一个字符串str,Arr数组长度增加1。

!SvrGetByteFromByteArr(ByRef ByteArr ,start, ByRef n, Flag)

函数意义:将字节数组ByteArr中从start位置开始的内容输出到变量n中,输出的格式为1字节整型,字节数组位置计数从1开始。 返 回 值:整型,判断是输出是否正常: 0: 正常; 小于0: 错误,具体意义如下: -1:启始索引start小于1 -2:启始索引start大于数组上限 -3:字节数组长度不足 -4:n 不是整型变量 -5:其他错误

参 数:ByteArr,传址型,字节型数组。 start,整型,输出的首位置,从1开始。 n,传址型,长整型;

Flag, 长整型,解析方式[0:8位无符号;1:8位有符号;2:8位BCD码] 实 例:! SvrGetByteFromByteArr (BA,2, A,1),字节数组为:00 01 02 03 04 05 06 07 08 09 00 00 则A=1。

!SvrGetShortFromByteArr(ByRef ByteArr ,start, ByRef n, Flag)

函数意义:将字节数组ByteArr中从start位置开始的内容输出到变量n中,输出的格式为2