FS_READ機能ブロック

このFS_READ機能ブロックは、ファイルからデータを読み取ります。

注意: とても大きなファイルを読み取る場合、PLCまたはシステム全体がクラッシュし、起動できなくなる可能性があります。入力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で、エラーが発生していない場合です。この状態は後で使用するために保存されます。

可能性のある原因:

  • ストレージメディアのサービスが開始されていません。
  • ストレージが初期化されていません。
  • ログイン情報が無効です。
  • リモートサーバーにアクセスできませんでした。
  • ストレージメディアが存在しません。
  • 指定されたパスが無効です。