CWRITE 或 SWRITE 的格式規范具有以下結構：“%U”

F:格式化字符。可選的。

W:要輸出的最小位置數。可選的。

G:精度規格

U:轉換字符

例1:

整數變量 VI 的值以十進制和十六進制 ASCII 表示法傳輸。第一個 CWRITE 語句傳送字符 123。第二個 CWRITE 語句傳送字符 7B。

命令通道 $FCT_CALL 的功能

使用 CWRITE 調用命令通道 $FCT_CALL 的文件系統函數。調用時，函數參數必須作為 Var1 … Var10 傳送到 CWRITE。此外，CWRITE 傳輸的寫入模式必須是#SYNC。

默認情況下，函數訪問的文件存儲在本地目錄C:KRCROBOTERUserFiles。存儲在那里的文件的最大總大小限制為 10 MB，即存儲在那里的所有文件的總大小不得超過此限制。也可以通過函數 krl_mount() 使用啟用的網絡驅動器。

可以從機器人解釋程序或提交解釋程序調用文件系統函數。不允許從一個解釋器打開文件，然后從另一個解釋器訪問它，例如 寫入或再次關閉文件。

錯誤處理

每個文件系統函數通過 CWRITE 提供一個返回值，可以在 KRL 程序中查詢和評估。返回值指示函數是成功執行還是因錯誤而中止。

調用 CWRITE 時傳遞的變量 State.RET1 用于監控是否發生錯誤：

State.RET1= #DATA_OK：函數執行成功

State.RET1= #CMD_ABORT: 函數因錯誤而取消

在發生錯誤的情況下，返回的錯誤號可用于定位原因。使用變量 State.MSG_NO 輪詢錯誤號。描述了每個功能的可能錯誤編號。

$FCT_CALL: 將字符寫入文件

命令通道 $FCT_CALL 的管理號（句柄）

CWRITE() 函數可用于通過 $FCT_CALL 命令通道調用函數。變量本身是寫保護的。

$FCT_CALL=Number

字符“a”將通過命令通道 $FCT_CALL 寫入文件MyTest.TXT。如果文件已經存在，則在打開文件時刪除文件的內容。

對于使用 CWRITE 的每個函數調用，都要進行檢查以查看函數是成功執行還是因錯誤而中止。如果發生錯誤，可以根據錯誤原因編程相應的錯誤處理。如果沒有發生錯誤，將寫入字符并再次關閉文件.

krl_fopen()

打開一個文件

根據選擇的模式，文件以文本文件或二進制文件的形式打開以進行讀訪問和/或寫訪問。可用模式對應于頭文件 stdio.h 的 fopen() 函數。

在 KRL 程序中使用此功能最多可以同時打開 11 個文件。

krl_fopen(CHAR[] Name, CHAR[] Mode, INT Handle <, BUFF_MODE_T Buffering> )

Mode

“r”

作為文本文件打開以進行讀取訪問

在這種模式下，一個文件可以連續打開多次（包括由機器人和提交解釋器同時打開）而無需先關閉。在每種情況下都會返回一個不同的句柄。這些句柄中的每一個都必須在某個時候關閉，因為否則無法以不同的模式打開文件。

“w”

作為文本文件打開以進行寫訪問

在這種模式下，文件的內容在打開時被刪除。如果他的文件不存在，則創建它。

“a”

作為文本文件打開以進行寫訪問

在這種模式下，文件的內容在打開時不會被刪除；相反，寫入的值被添加到文件的末尾。如果文件不存在，則創建它。

“rb”

作為二進制文件打開以進行讀取訪問

“wb”

作為二進制文件打開以進行寫訪問

“r+”

作為文本文件打開以進行讀寫訪問

注意：打開文件后，文件指針指向文件的開頭。為確保在將數據寫入文件時不會覆蓋任何內容，必須通過函數 krl_fseek() 將文件指針放在文件末尾。

例：

文件 ROBOTERUserFilesMyFile.txt 作為文本文件打開以進行讀取訪問：

CWRITE($FCT_CALL, State, Mode, "krl_fopen", "MyFile.txt", "r", FileHandle)

文件 ROBOTERUserFiles estMyFile.txt 作為二進制文件打開，用于讀寫訪問。

如果該文件已存在，則刪除該文件的內容。

如果文件不存在，則創建它：

CWRITE($FCT_CALL, State, Mode, "krl_fopen", "Test/MyFile.txt", "wb+", FileHandle)

MyFile.txt 文件作為文本文件打開，用于讀取訪問，無需在啟用的網絡驅動器上進行緩沖。

名稱為 Net1 的網絡驅動器的掛載點必須首先通過 krl_mount() 創建：

CWRITE($FCT_CALL, State, Mode, "krl_fopen", "/Net1/MyFile.txt", "r",

FileHandle, #NO_BUFF)

krl_fclose()

關閉文件

該文件由傳輸的句柄明確確定。一旦文件被關閉，句柄就無效并且不能用于進一步的文件系統操作。

當文件關閉時，寫入緩沖區的內容將寫入文件。

krl_fclose(INT Handle)

文件通過文件句柄關閉：CWRITE($FCT_CALL, State, Mode, "krl_fclose", FileHandle)

krl_fputc()

將字符寫入文件

文件中寫入字符的點取決于打開文件的模式和文件指針的位置。

krl_fputc(INT Handle, CHAR Character)

字符“x”被寫入句柄傳輸的文件中：CWRITE($FCT_CALL, State, Mode, "krl_fputc", FileHandle, "x")

krl_fputs()

將字符串寫入文件

該函數可用于將常量字符串或可變字符串寫入文件。

如果使用變量，則 CHAR 數組的每個元素都必須初始化并包含一個有效值。

文件中寫入字符串的點取決于打開文件的模式和文件指針的位置。

krl_fputs(INT Handle, CHAR[] String)

例：

一個常量字符串被寫入到句柄傳送的文件中：

CWRITE($FCT_CALL, State, Mode, "krl_fputs", FileHandle, "write this!")

將變量“StringVar[]”中包含的字符串寫入句柄傳送的文件中：

CWRITE($FCT_CALL, State, Mode, "krl_fputs", FileHandle, StringVar[])

krl_fwriteln()

將字符串逐行寫入文件

該函數可用于將常量字符串或可變字符串寫入文件。將行尾字符附加到要寫入的字符串。

如果使用變量，則 CHAR 數組的每個元素都必須初始化并包含一個有效值。

文件中寫入字符串的行取決于打開文件的模式和文件指針的位置。

krl_fwriteln(INT Handle, CHAR[] String)

將一個空行寫入句柄傳輸的文件中：

CWRITE($FCT_CALL, State, Mode, "krl_fwriteln", FileHandle, " ")

krl_fprintf()

將字符串格式化寫入文件

要寫入的格式作為字符串傳送給函數。要寫入的值也會被傳送。

可用格式在頭文件 stdio.h 的 fprintf() 函數的文檔中列出。

除了“%o”、“%p”、“%n”和列表“[List]”之外，所有格式都是允許的。

krl_fprintf(INT Handle, CHAR[] Format, Par1, … , Par8)

由字符“;”分隔的 3 個值 被寫入由句柄傳輸的文件并格式化：

CWRITE($FCT_CALL, State, Mode, "krl_fprintf", FileHandle, "%s;%x;%c", "Item1", 'HA0', CharVar)

krl_fsizeget()

確定文件大小,文件大小以字節為單位。此函數只能用于確定首先使用 krl_fopen() 打開的文件的大小。

krl_fsizeget(INT Handle, INT Size )

由句柄傳輸的文件的大小被確定并寫入變量“IntVar”：

CWRITE($FCT_CALL, State, Mode, "krl_fsizeget", FileHandle, IntVar)

例:

DECL INTHANDLE DECL STATE_T STAT DECL MODUS_T MODE

...

CHAR MYCHAR

...

MODE =#SYNC HANDLE = 0 MYCHAR = "a"

...

; 在 C:KRCROBOTERUserFiles 下創建一個文件

CWRITE($FCT_CALL, STAT, MODE,"krl_fopen", "MyTest.TXT", "w", HANDLE)

; 檢查是否發生錯誤

IF (STAT.RET1 == #CMD_ABORT)THEN

IF (STAT.MSG_NO == -5) THEN

; 如果有很多文件已經打開，則錯誤處理...

ELSE

; 如果需要，檢查其他錯誤代碼

... ENDIF

ELSE

; 沒有發生錯誤

; 將字符寫入文件

CWrite($FCT_CALL, STAT, MODE, "krl_fputc",HANDLE, MYCHAR) IF (STAT.RET1 == #CMD_ABORT) THEN

; 錯誤處理

... ENDIF

; 關閉文件

CWRITE($FCT_CALL, STAT, MODE,"krl_fclose", HANDLE) IF (STAT.RET1 == #CMD_ABORT) THEN

錯誤處理

... ENDIF

ENDIF

大家有空可以試試吧！

審核編輯：劉清