Carey's Dream Travel

Tera Term TTL command description

https://teratermproject.github.io/manual/5/en/macro/command/index.html

clearscreen <int>：清屏。 int=0時清屏，int=1時清屏+清緩衝區

dispstr <data1> [<data2>....]：在螢幕上輸出字元。注意：data如果是數字，會取低8位元作為ASCII字元進行列印，而不是把data當成數字列印；在螢幕上輸出的字元僅本地可見，對遠端沒有影響。

fluashrecv：清空接收字元快取。防止wait指令從接收快取讀取到異常字元。

gethostname <strvar>：把主機名稱/IP位址存放到strvar字串變數裡。可以用作日誌輸出。

unlink：中斷目前巨集（腳本）和目前連線之前的連線。這裡涉及到巨集和Teraterm和單一host的關係。巨集首先連結到Teraterm，在整個TeraTerm範圍下可以發起新連線。巨集也可以連結到單一host，在單一host裡向遠端控制台發送指令。

logclose：關閉日誌文件

logopen <filename> <binary flag> <append flag> [<plain text flag> [<timestamp flag> [<hide dialog flag> [<include screen buffer flag> [<timestamp type]]]]]：把收到的字元輸出到filename檔中，後面都是flag。

filename：不指定目錄的時候，預設輸出到teraterm的目前目錄（可用changedir變更）
binary flag：0-CR轉換為CRLF，轉義符被剔除；1-不轉換，收到什麼存什麼
append flag：0-建立新文件，覆蓋現有文件；1-建立新文件，在現有文件追加
plain text flag：1-非ASCII可見字元不輸出到log。
（一般下面不用看）

timestamp flag：1-在每一行log加入時間戳
binary flag：1-忽略plain text flag和timestamp flag
hide dialog flag：1-不顯示Log對話框
include screen buffer flag：1-目前螢幕緩衝區在log開啟後立即寫入log
timestamp type：時間戳記類型。例如0-本地時間，1-UTC時間
logpause：接下來收到的字元不要寫入log。和logstart搭配使用，logstart恢復log記錄。

logwrite <string>：寫一句string到log，string不能是空的。

send <data1> <data2>....：發送字元。 data裡面有整數時，取整數的低8位元視為ASCII字元進行傳送。

sendln <data1> <data2>....：傳送字符，最後加一個回車。

wait <string1> [<string2> ...]：等待最多10個字串中任一個的出現。字串為空時代表一個任意字元。系統變數timeout/mtimeout大於零時代表最長等待時間。等待結果存放在系統變數result中，0為超時，n為第n個字串出現了。

waitln <string1> [<string2> ...]：以行為單位的wait。

wait4all <string1> [<string2> ...]：等待10個字串的同時出現。

waitevent <events>：等待event出現，例如events=4時代表disconnect。

waitrecv <sub-string> <len> <pos>：等待接收到符合某個條件的字串。條件具體指的是總長為len，從pos位置開始是sub-string。

waitregex <string1 with regular expression> [<string2 with regular expression> ...]：等一個符合正規表示式的字串出現。

控制語句：
pause <time>：像其他語言的sleep，等待time秒。
字串操作：
int2str <strvar> <integer value>：整數轉字串。
str2int <intvar> <string>：字串轉整數。
sprintf FORMAT [ARGUMENT ...]：類似c語言sprintf，輸出格式字串到系統變數inputstr。
sprintf2 strvar FORMAT [ARGUMENT ...]：類似c語言sprintf，輸出格式字串到變數strvar中。