功能區塊 FS_READLINE

功能區塊 FS_READLINE 會從檔案中逐行讀取資料。

注意： 在讀取非常大的檔案時，可編程邏輯控制器或整個系統可能會崩潰並無法再啟動。

提示： 由於安全原因，一行最大可讀取的大小為 1024'000 位元組。

必須先使用 FS_INIT 初始化檔案系統。所有操作均以非同步方式針對每個建立的儲存媒體進行。

輸入 READ

在正邊緣時，會從儲存媒體讀取資料。

輸入 DEV

定義要存取檔案的裝置。該裝置是專案用途的，並可在 專案 ▸ 外部儲存 的內容功能表中管理。

輸入 PATH

指定儲存媒體上檔案的路徑。如果支援，則該路徑對應於 UTF-8 格式的 Unix 檔案路徑。路徑如下所示：

資料夾/子資料夾/檔案.txt

輸入 LINE

定義要讀取的行。第一行從編號 0 開始。

輸入 ENDING

定義行結尾。使用 Escape 字元指定："\r\n"。如果未定義輸入，則假設為 "\n"。

在下列字元中會考慮 Escape 字元：

• "\t" (ASCII 9 (0x09))，一個定位字符。
• "\n" (ASCII 10 (0x0A))，換行符號 (Line Feed)。
• "\r" (ASCII 13 (0x0D))，一個回車字符 (Carriage Return)。
• "\0" (ASCII 0 (0x00))，NUL 位元組。
• '\xEF' 位元組的寫入形式。

提示： 若要定義二進位字元，例如 '\xEF'，則必須以單引號定義這些字元。

輸出 DONE

在成功時，輸出會傳回一個脈衝，以執行下一個操作。當結束程序時，即使發生錯誤也會發生脈衝。

輸出 DATA

傳回讀取的行，包括行尾。狀態會儲存以供稍後使用。

輸出 EOF

如果已達到檔案末端，則輸入為真。

輸出 BOM

如果找到 UTF-8 位元組順序標記，則輸出為真。BOM 在每次讀取作業時都會判定。

輸出 ERROR

在錯誤情況下，傳回包含錯誤訊息的文字。如果沒有發生錯誤，則為 FALSE。狀態會儲存以供稍後使用。

可能原因：

• 未啟動儲存媒體的服務。
• 未初始化儲存體。
• 登入資料無效。
• 無法連線到遠端伺服器。
• 不存在儲存媒體。
• 指定的路徑無效。