功能區塊 FS_READ

功能區塊 FS_READ 讀取檔案中的資料。

注意： 讀取非常大的檔案時，可編程邏輯控制器或整個系統可能會崩潰並無法再啟動。請謹慎使用輸入 LENGTH=0。

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

輸入 READ

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

輸入 DEV

定義要存取檔案的裝置。該裝置是專案用途的，並可透過 專案 ▸ 外部儲存 的內容選單進行管理。

輸入 PATH

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

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

輸入 OFFSET

定義要從哪個位移（以位元組為單位）開始讀取。如果未定義任何位移，則會從檔案開頭開始讀取。

輸入 LENGTH

定義在停止讀取之前的最大長度。如果未定義該輸入，則會讀取到檔案結尾為止。

提示： 在 LENGTH=0 時，安全起見，最大可讀取的大小為 1,024,000 位元組。

輸出 DONE

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

輸出 DATA

傳回已讀取的資料。狀態會儲存以供稍後使用。

輸出 EOF

如果已達到檔案結尾，則該輸入為真。

輸出 BOM

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

輸出 ERROR

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

可能原因：

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