FS_READLINE機能ブロック

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

注意: とても大きなファイルを読み取る場合、PLCまたはシステム全体がクラッシュし、起動できなくなる可能性があります。

ヒント: セキュリティ上の理由から、1行で読み取れる最大サイズは1024'000バイトです。

ファイルシステムはFS_INITを使用して事前に初期化する必要があります。すべての操作は、作成された各ストレージメディアごとに非同期で行われます。

入力READ

正のエッジが生じると、データがストレージメディアから読み取られます。

入力DEV

このデバイスは、ファイルにアクセスするために使用されるものを定義します。デバイスはプロジェクトごとに使用され、プロジェクト 外部ストレージのコンテキストメニューで管理できます。

入力PATH

このパスは、ストレージメディア上のファイルへのパスを指定します。このパスは、UTF-8形式のUnixファイルパスに対応しています(サポートされている場合)。このパスは次のように表示されます。

フォルダ/サブフォルダ/ファイル.txt

入力LINE

読み取る行を定義します。最初の行は番号0から始まります。

入力ENDING

この行末を定義します。これはエスケープ文字で指定されます:"\r\n"。この入力が定義されていない場合、"\n"が想定されます。

次の文字ではエスケープ文字が考慮されます:

  • "\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です。エラーが起こらなかった場合。この状態は後で使用するために保存されます。

可能性のある原因:

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