中斷性變更 8.0 -> 9.0

  • receive.isHexDisplay(); 變更為 receive.isHexDisplay;
  • receive.isAutoBreakFrame(); 變更為 receive.isAutoBreakFrame;
  • this.SourceDataBuffer; 已刪除 建議使用 send.getBytes();

receive 類

跟接收數據相關的屬性和方法。

屬性 描述
receive.isFrameStart 幀開始標誌
receive.isHexDisplay 是否Hex顯示
receive.isSaveToFile 是否保存到檔
receive.isPauseReceivingDisplay 是否暫停接收
receive.isAutoBreakFrame 是否自動斷幀
receive.currentRowIsEmpty 接收視窗當前行是否為空
方法 描述
receive.get() 參考 receive.getString()
receive.getString() 當前接收的字串
1.使用字元編碼轉換后的字串()
2.Hex格式的字串(當使能十六進制顯示時)
receive.getBytes() 目前接收到的位元組陣列(原始資料)
receive.write(string) 向顯示視窗寫入字串
string 要發送的字串
receive.write(string,colorStr) 向顯示視窗寫入字串
string 要發送的字串
colorStr 顏色字串。 例如 "red" "yellow" "#FF00FF00"
receive.clear() 清空接收視窗
receive.clearLastReceived() 清空上次接收數據

send 類

跟發送數據相關的屬性和方法。

屬性 描述
send.isSendFile 是否發送檔
send.isHexSend 是否Hex發送
send.isTimingSend 是否定時發送
send.isDisplaySendString 是否顯示發送字串
方法 描述
send.get() 當前發送的字串
send.getString() 當前發送的字串
send.getBytes() 獲取當前發送位元組陣組
send.write(string) 發送字串
send.write(string,isHexStr) 是否是發送HEX格式的字串
string 要發送的字串
isHexStr 字串是否是十六進位樣式
例如:
send.write("AB CD 12",true);
send.writeBytes(Array) 發送位元組陣組
Array Uint8Array陣列,其他類型會先轉換為Uint8Array再發送。
//創建長度為10的陣列,初始化后併發送
buf = new Uint8Array(10);
for (let i = 0; i < 10; i++) 
    buf[i]=i; 
send.writeBytes(buf);

//Array 類型陣列
buf = Array(2, 3, 4, "5");
send.writeBytes(buf);
send.writeToReceice(string) 從發送文稿向接收視窗寫字串
建議使用 receive.write(string)
send.writeToReceice(string,color) 從發送文稿向接收視窗寫字串
建議使用 receive.write(string,colorStr)

chart

繪圖控件操作類,包含向繪圖控件發送數據的方法

方法 描述
chart.write(formatStr) 向繪圖控件寫入數據
formatStr 符合繪圖協定的字串
例如:
chart.write("line1=12.2\n");
chart.write("line1=100,line2=200\n");
chart.write(name,datas) 向繪圖控件寫入數據
name 波形名稱
datas 波形資料(支援數值,字串,陣列)
例如:
chart.write("line1",100);
chart.write("line1","200");
chart.write("line1",[20,"10",50]);

console

列印調試資訊到輸出視窗

方法 描述
console.log(obj) 列印到輸出視窗
console.dir(obj) 格式化列印
console.error(obj) 錯誤 紅色
console.warn(obj) 警告 深綠色
console.write(obj,,,color) 列印物件
obj,,, 支援多個參數
color 最後一個參數,可控制字元顏色
console.time() 開始計時
console.timeEnd() 結束計時,並在輸出視窗列印所用時間。
和console.time()配合使用統計代碼運行時間

util

輔助工具類

方法 描述
util.isNull(object) 是否為null
util.isNullOrUndefined(object) 是否為null或未定義
util.isUndefined(object) 是否未定義
util.timeToString() 獲取時間字符串 h:m:s.ms
util.hexStringToBytes(string) 字符串轉字節數組
string 十六進制格式字符串 "68 65 6C 6C 6F"
util.bytesToHexString(bytes, isUpper = false) 字節數組轉為16進製字符串
bytes 字節數組
isUpper 大寫字母(預設小寫字母)
util.bytesToInteger(buf, index, len, bigEndian = true) 字節數組轉整數
buf 字節數組
index 起始索引
len 整數佔用位元組數量
bigEndian 使用大端字節順序
util.bytesTofloat(buf, index, bigEndian = true) IEEE754 float 內存數組(4字節) 轉為 float
buf 字節數組
index 起始索引
bigEndian 使用大端字節順序

類型檢查

util.types.isBoolean(object) 是否布爾類型
util.types.isNumber(object) 是否數位
util.types.isString(object) 是否字串
util.types.isFunction(object) 是否函數
util.types.isInt8Array(object) 是否 8 位有符號整數數位
util.types.isUint8Array(object) 是否 8 位無符號整數陣列
util.types.isInt16Array(object) 是否 16 位有符號整數陣列
util.types.isUint16Array(object) 是否 16 位無符號整數陣列

file

文件操作

方法 描述
file.exists(path) 確定指定的檔案是否存在。
path 文件路徑
file.readText(path) 將文件中的所有文本讀取到一個字串中。
path 文件路徑
file.writeText(path, string) 將字串寫入文件(UTF-8編碼)
path 文件路徑
string 文本字串
file.appendText(path,str) 將字串新增至文字末尾(UTF-8編碼)
path 文件路徑
string 文本字串
file.readBytes(path) 將文件的內容讀入一個字節數組
path 文件路徑
file.writeBytes(path, bytes) 將字節數組寫入文件
path 文件路徑
bytes 字節數組
file.appendBytes(path, bytes) 將字元字節數組加到文字末尾
path 文件路徑
bytes 字節數組
file.getTempPath(path, bytes) 返回目前使用者的臨時資料夾的路徑。
file.delete(path) 刪除指定的文件
path 檔案路徑

其他

方法 描述
alert(title, message) 顯示警告框
title 標題
message 消息
delay(ms) 異步延時 (謹慎使用)
ms 毫秒
sleep(ms) 掛起線程 (謹慎使用)
ms 毫秒