【正文】 時數(shù)據(jù)變量的名字對變量進(jìn)行設(shè)置，假設(shè)該實(shí)時數(shù)據(jù)變量為整型（開關(guān)型）變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要設(shè)置的變量名的字符串。 n，整型，需要設(shè)定的整型值實(shí) 例：!SetIntDataValueByName(發(fā)電機(jī)啟動,1)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“發(fā)電機(jī)啟動”的值設(shè)為1；該函數(shù)一般用于設(shè)備命令的處理過程中。!SetSingleDataValueByName(DataStr,x)函數(shù)意義：根據(jù)實(shí)時數(shù)據(jù)變量的名字對變量進(jìn)行設(shè)置，假設(shè)該實(shí)時數(shù)據(jù)變量為單精度浮點(diǎn)型（數(shù)值型）變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要設(shè)置的變量名的字符串。 x，單精度數(shù)值型，需要設(shè)定的數(shù)值實(shí) 例：!SetSingleDataValueByName(溫度,)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“溫度”；該函數(shù)一般用于設(shè)備命令的處理過程中。!SetStrDataValueByName(DataStr,str)函數(shù)意義：根據(jù)實(shí)時數(shù)據(jù)變量的名字對變量進(jìn)行設(shè)置，假設(shè)該實(shí)時數(shù)據(jù)變量為字符型變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要設(shè)置的變量名的字符串。 str，字符型，需要設(shè)定的值實(shí) 例：!SetStrDataValueByName(顯示內(nèi)容,通訊正常)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“顯示內(nèi)容”的值設(shè)為”通訊正常”； 該函數(shù)一般用于設(shè)備命令的處理過程中。!GetIntDataValueByName(DataStr,ByRef n)函數(shù)意義：根據(jù)實(shí)時數(shù)據(jù)變量的名字，將該變量的值讀出，假設(shè)該實(shí)時數(shù)據(jù)變量為整型變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要讀取的變量名的字符串。 n，引用型，整型，保存讀出值的變量；實(shí) 例：! GetIntDataValueByName (發(fā)電機(jī)啟動,n)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“顯示內(nèi)容”的值讀出，賦給變量n；該函數(shù)一般用于設(shè)備命令的處理過程中。!GetSingleDataValueByName(DataStr,ByRef x)函數(shù)意義：根據(jù)實(shí)時數(shù)據(jù)變量的名字，將該變量的值讀出，假設(shè)該實(shí)時數(shù)據(jù)變量為單精度浮點(diǎn)型變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要讀取的變量名的字符串。 x，引用型，單精度浮點(diǎn)型，保存讀出值的變量；實(shí) 例：! GetSingleDataValueByName (溫度,x)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“溫度”的值讀出，賦給變量x；該函數(shù)一般用于設(shè)備命令的處理過程中。!GetStrDataValueByName(ArrName,str)函數(shù)意義：根據(jù)實(shí)時數(shù)據(jù)變量的名字，將該變量的值讀出，假設(shè)該實(shí)時數(shù)據(jù)變量為字符型變量；返 回 值：整型。1 失敗，0 成功。參 數(shù)：DataStr，字符型，需要讀取的變量名的字符串。 str，引用型，字符型，保存讀出值的變量；實(shí) 例：! GetIntDataValueByName (顯示內(nèi)容,str)。實(shí)例說明：將實(shí)時數(shù)據(jù)變量“顯示內(nèi)容”的值讀出，賦給變量str；該函數(shù)一般用于設(shè)備命令的處理過程中。!ArrayResize(ArrName, n)函數(shù)意義：重新設(shè)置數(shù)組的大小。 返 回 值：整型。1 失敗，0 成功。參 數(shù)：ArName，數(shù)組名稱。 n，整型，需要設(shè)置的數(shù)組大?。粚?shí) 例：! ArrayResize(bArr, 10)。實(shí)例說明：將數(shù)組bArr的大小設(shè)定為10。!ArrayAppend(ArrName1, ArrName2)函數(shù)意義：把一個字節(jié)數(shù)組追加到另外一個數(shù)組的后面。要求兩個數(shù)組類型一致。數(shù)組長度變?yōu)閮蓴?shù)組長度之和。返 回 值：1 失敗； =0 追加之后新數(shù)組的大小。參 數(shù)：ArrName1，數(shù)組名稱1，追加內(nèi)容后生成的數(shù)組。 ArrName2，數(shù)組名稱2，追加到另外一個數(shù)組后面的內(nèi)容。實(shí) 例：! ArrayAppend(ArrA, Arrb)。實(shí)例說明：將數(shù)組ArrB的內(nèi)容追加到數(shù)組ArrA之后，ArrA數(shù)組的長度變?yōu)锳rrA與ArrB兩個數(shù)組長度之和。!ArrayCopy(ArrDes, ArrSrc)函數(shù)意義：把一個數(shù)組復(fù)制到另外一個數(shù)組。兩者必須是同一類型，把源數(shù)組的內(nèi)容復(fù)制到目標(biāo)數(shù)組中去。 目標(biāo)數(shù)組的大小也更源數(shù)組一致。返 回 值：1 失敗，0 成功參 數(shù)：ArrDes，數(shù)組名稱，復(fù)制生成的數(shù)組，該數(shù)組原內(nèi)容和大小將會被新設(shè)置覆蓋。 ArrSrc，數(shù)組名稱，復(fù)制生成數(shù)組的源內(nèi)容，新生成數(shù)組內(nèi)容跟它一致。實(shí) 例：! ArrayCopy(ArrDes, ArrSrc)。實(shí)例說明：根據(jù)數(shù)組ArrSrc 的內(nèi)容，復(fù)制出一個同樣的數(shù)組 ArrDes。!ArrayGetSize(Arr)函數(shù)意義：求數(shù)組的長度。返 回 值：1 失敗， =0 數(shù)組的長度。參 數(shù)：Arr ，數(shù)組名稱，求長度的數(shù)組。實(shí) 例：! ArrayGetSize(Arr)。實(shí)例說明：求數(shù)組Arr的長度。!ArrayIntAdd(Arr, n)函數(shù)意義：在一個整型數(shù)組后面添加一個整數(shù)元素，數(shù)組長度加1。返 回 值：1 失敗， 0 成功。參 數(shù)：Arr ，數(shù)組名稱，需要增加整數(shù)元素的整數(shù)數(shù)組。 n， 整數(shù)，需要添加的整數(shù)元素。實(shí) 例：! ArrayIntAdd(Arr, 5)。實(shí)例說明：在數(shù)組Arr的末尾增加一個數(shù)值為5的元素，Arr數(shù)組長度增加1。!ArraySingleAdd(Arr, x)函數(shù)意義：給一個浮點(diǎn)數(shù)組添加一個浮點(diǎn)數(shù)元素，數(shù)組長度加1。返 回 值：1 失敗， 0 成功。參 數(shù)：Arr ，數(shù)組名稱，需要增加浮點(diǎn)數(shù)元素的浮點(diǎn)數(shù)組。 x，浮點(diǎn)數(shù)，添加的浮點(diǎn)數(shù)。實(shí) 例：! ArraySingleAdd(Arr, )。實(shí)例說明：，Arr數(shù)組長度增加1。!ArrayByteAdd(Arr, b)函數(shù)意義：給一個字節(jié)數(shù)組添加一個字節(jié)元素，數(shù)組長度加1。返 回 值：1 失敗, 0 成功。參 數(shù)：Arr ，數(shù)組名稱，需要添加字節(jié)元素的字節(jié)數(shù)組。 b，字節(jié)，添加的字節(jié)元素。實(shí) 例：! ArrayByteAdd(Arr, b)。實(shí)例說明：在字節(jié)數(shù)組Arr的末尾增加一個字節(jié) b，Arr數(shù)組長度增加1。!ArrayStringAdd(Arr, str)函數(shù)意義：給一個字符串?dāng)?shù)組添加字符串元素，數(shù)組長度加1。返 回 值：1 失敗， 0 成功。參 數(shù)：Arr ，數(shù)組名稱，需要添加元素的字符串?dāng)?shù)組。 b，字符串，添加到數(shù)組的字符串。實(shí) 例：! ArrayStringAdd(Arr, str)。實(shí)例說明：在字節(jié)數(shù)組Arr的末尾增加一個字符串str，Arr數(shù)組長度增加1。!SvrGetByteFromByteArr(ByRef ByteArr ，start, ByRef n, Flag)函數(shù)意義：將字節(jié)數(shù)組ByteArr中從start位置開始的內(nèi)容輸出到變量n中，輸出的格式為1字節(jié)整型，字節(jié)數(shù)組位置計(jì)數(shù)從1開始。返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下： 1：啟始索引start小于1 2：啟始索引start大于數(shù)組上限 3：字節(jié)數(shù)組長度不足 4：n 不是整型變量 5：其他錯誤參 數(shù)：ByteArr，傳址型，字節(jié)型數(shù)組。 start，整型，輸出的首位置，從1開始。 n，傳址型，長整型； Flag, 長整型,解析方式[0：8位無符號；1：8位有符號；2：8位BCD碼]實(shí) 例：! SvrGetByteFromByteArr (BA,2, A，1)，字節(jié)數(shù)組為：00 01 02 03 04 05 06 07 08 09 00 00 則A=1。!SvrGetShortFromByteArr(ByRef ByteArr ，start, ByRef n, Flag)函數(shù)意義：將字節(jié)數(shù)組ByteArr中從start位置開始的內(nèi)容輸出到變量n中，輸出的格式為2字節(jié)整型，字節(jié)數(shù)組位置計(jì)數(shù)從1開始。返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下: 1：啟始索引start小于1 2：啟始索引start大于數(shù)組上限 3：字節(jié)數(shù)組長度不足 4：n 不是整型變量 5：其他錯誤參 數(shù)：ByteArr，傳址型，字節(jié)型數(shù)組。 start，整型，輸出的首位置，從1開始。 n，傳址型，長整型； Flag, 長整型,解析方式[0：16位無符號；1：16位有符號；2：16位BCD碼]實(shí) 例：! SvrGetByteFromByteArr (BA,2, A，1)，字節(jié)數(shù)組為：00 01 02 03 04 05 06 07 08 09 00 00 則A=513。!SvrGetIntFromByteArr(ByRef ByteArr ，start, ByRef n, Flag)函數(shù)意義：將字節(jié)數(shù)組ByteArr中從start位置開始的內(nèi)容輸出到變量n中，輸出的格式為4字節(jié)整型，字節(jié)數(shù)組位置計(jì)數(shù)從1開始。返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下: 1：啟始索引start小于1 2：啟始索引start大于數(shù)組上限 3：字節(jié)數(shù)組長度不足 4：n 不是整型變量 5：其他錯誤參 數(shù)：ByteArr，傳址型，字節(jié)型數(shù)組。 start，整型，輸出的首位置，從1開始。 n，傳址型，長整型； Flag, 長整型,解析方式[0：32位無符號；1：32位有符號；2：32位BCD碼]實(shí) 例：! SvrGetIntFromByteArr (BA,2, A，1)，字節(jié)數(shù)組為：00 01 02 03 04 05 06 07 08 09 00 00 則A=67305985 。!SvrGetSingleFromByteArr(ByRef ByteArr ，start, ByRef x, Flag)函數(shù)意義：將字節(jié)數(shù)組ByteArr中從start位置開始的內(nèi)容輸出到變量x中，輸出的格式為4字節(jié)數(shù)值型，字節(jié)數(shù)組位置計(jì)數(shù)從1開始。返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下: 1：啟始索引start小于1 2：啟始索引start大于數(shù)組上限 3：字節(jié)數(shù)組長度不足 4：n 不是浮點(diǎn)型變量 5：其他錯誤參 數(shù)：ByteArr，傳址型，字節(jié)型數(shù)組。 start，整型，輸出的首位置，從1開始。 n，傳址型，長整型； Flag, 長整型,對應(yīng)4種解碼次序[數(shù)值范圍：0~3]實(shí) 例：SvrGetSingleFromByteArr(BA,1, x，3) 字節(jié)數(shù)組為：00 00 80 40 04 05 06 07 08 09 00 00 則A=。!SvrGetByteFromHexStr(str, ByRef n, Flag)函數(shù)意義：獲得將HEX表示的字符數(shù)據(jù)的內(nèi)容輸出到變量x中，輸出的格式為1字節(jié)數(shù)值型，從頭取2個字符轉(zhuǎn)換成一個字節(jié)HEX值返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下: 1：解析字符長度不足，至少長度為2字符 2：解析字符長度一定為偶數(shù)個 3：解析字符長度大于2個，只取左邊2字符解析 4：變量類型，不是整形 5：其他錯誤參 數(shù)：str，字符數(shù)據(jù)。 n，傳址型，長整型； Flag, 長整型,解析方式[0：8位無符號；1：8位有符號；2：8位BCD碼]實(shí) 例：! SvrGetByteFromHexStr (str，n，0)，str為：“0102030405060708” 則n = 1。!SvrGetShortFromHexStr(str, ByRef n, Flag)函數(shù)意義：獲得將HEX表示的字符數(shù)據(jù)的內(nèi)容輸出到變量x中，輸出的格式為2字節(jié)數(shù)值型，從頭取4個字符轉(zhuǎn)換成2個字節(jié)短整型值返 回 值：整型，判斷是輸出是否正常： 0： 正常； 小于0： 錯誤，具體意義如下: 1：解析字符長度不足，至少長度為4字符 2：解析字符長度一定為偶數(shù)個 3：解析字符長度大于2個，只取左邊2字符解析 4：變量類型，不是整形 5：其他錯誤參 數(shù)：str，字符數(shù)據(jù)。 n，傳址型，長整型； Flag, 長整型,解析方式[0：16位無符號；1：16位有符號；2：16位BCD碼]實(shí) 例：!SvrGetShortFromHexStr (str，n，0) str為：“02010304