功能區塊 FS_WRITE
功能區塊 FS_WRITE 將資料寫入檔案系統。
注意： 已經存在的檔案會在沒有警告的情況下被覆蓋。
必須先透過 FS_INIT 初始化檔案系統。所有操作都是以每個建立的儲存媒體為單位非同步進行的。
輸入 WRITE
在正邊緣時，資料會被寫入儲存媒體。
輸入 DEV
定義要從哪個裝置存取檔案。該裝置是專案用的，並且可以在 專案 外部儲存 的內容選單中管理。
輸入 PATH
指定儲存媒體上的檔案路徑。如果支援的話，該路徑對應於 UTF-8 格式的 Unix 檔案路徑。路徑如下所示：
Folder/Subfolder/File.txt
輸入 DATA
定義要寫入的資料。
輸入 MODE
指定要以哪種模式寫入檔案。可能的模式如下：
| 模式 | 說明 |
|---|---|
| "r" | 僅供讀取。將檔案指標放在檔案開頭。 |
| "r+" | 僅供讀取和寫入。將檔案指標放在檔案開頭。 |
| "w" | 僅供寫入。將檔案指標放在檔案開頭。刪除檔案內容。如果檔案不存在，則建立該檔案。 |
| "w+" | 僅供寫入和讀取。將檔案指標放在檔案開頭。刪除檔案內容。如果檔案不存在，則建立該檔案。 |
| "a" | 僅供寫入。將檔案指標放在檔案結尾。如果檔案不存在，則建立該檔案。資料會附加到末端。 |
| "a+" | 僅供寫入和讀取。將檔案指標放在檔案結尾。如果檔案不存在，則建立該檔案。資料會附加到末端。 |
| "x" | 僅供寫入。將檔案指標放在檔案開頭。如果檔案存在，則中止。 |
| "x+" | 僅供寫入和讀取。將檔案指標放在檔案開頭。如果檔案存在，則中止。 |
| "c" | 僅供寫入。將檔案指標放在檔案開頭。如果檔案不存在，則建立該檔案。覆蓋檔案內容。 |
| "c+" | 僅供寫入和讀取。將檔案指標放在檔案開頭。如果檔案不存在，則建立該檔案。覆蓋檔案內容。 |
輸入 BOM
若寫入時輸入為真，則會在檔案開頭附加 UTF-8 位元組順序標記。這只會發生在檔案被覆蓋或新建立的情況下。如果沒有在檔案開頭寫入 BOM，則無法事後補上。
輸出 DONE
輸出在成功時會回傳一個脈衝，以執行下一個操作。該脈衝發生在操作結束時，即使發生錯誤也一樣。
輸出 LENGTH
回傳寫入的位元組數量。狀態會被儲存以供後續使用。
輸出 ERROR
在錯誤情況下，回傳一個包含錯誤訊息的文字。如果沒有發生錯誤，則為 FALSE。狀態會被儲存以供後續使用。
可能原因：
- 儲存媒體的服務未啟動。
- 儲存器沒有初始化。
- 登入資料無效。
- 無法連線到遠端伺服器。
- 儲存媒體不存在。
- 指定的路徑無效。
- 無法寫入儲存媒體。
- 儲存器沒有可用空間或已設為唯讀。