ネットワーク共有シェア変数から新規値を読み取ります。この関数は、すでに読み取られた可能性のある最新のデータ値を返さないで新規の値を待機し読み取ります。新規値が到着するか、指定したタイムアウトが過ぎるまで関数は実行を終了しません。

この関数を使用してすでに読み取ったデータ値を読み取ることを防ぎます。値が変更するかどうかに関係なく現在値を読み取る必要がある場合は、「変数を読み取る」関数を使用します。


icon

入力/出力

  • cgenclassrntag.png シェア変数refnum入力

    シェア変数Refnum入力は、シェア変数またはI/O変数コンテナのリファレンスです。

    このリファレンスを作成するには、入力端子を右クリックし、作成»制御器または作成»定数を選択します。制御器または定数をクリックし、参照を選択して変数オブジェクトを参照ダイアログボックスを表示します。変数リファレンスをプログラム的に検索することもできます。この入力端子は、文字列値も受け入れます。正確なNI-PSP変数アドレスが分かっている場合は、そのアドレスを文字列制御器に入力し、その文字列制御器をこの入力端子に直接配線できます。
  • cpoly.png データタイプ

    データ型は 、共有変数または I/O 変数コンテナの データ型を 指定する。I/O変数コンテナでは、配列データタイプを指定する必要があります。

    この入力は、データタイプが未指定の場合にのみ有効です。データタイプを指定するには、変数refnumのプロパティダイアログボックスの構成ページのデータタイプを指定チェックボックスをオンにします。接続開始時にデータタイプを指定すると、それ以降の読み取り関数と書き込み関数ではこの端子が無効となります。
  • ci32.png タイムアウト (ms)

    タイムアウト (ms) は、関数がタイムタウトするまで待機する時間をミリ秒単位で指定します。

    -1の値はタイムアウトなしを指定します。デフォルトは0です。タイムアウト?出力を使用してタイムアウトを検出します。
  • cerrcodeclst.png エラー入力 (エラーなし)

    エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

  • igenclassrntag.png シェア変数refnum出力

    シェア変数Refnum出力は、シェア変数またはI/O変数コンテナのリファレンスです。

  • ipoly.png データ出力

    データ出力は、シェア変数またはI/O変数コンテナから読み取られたデータです。

  • ibool.png タイムアウト?

    タイムアウト?は、新規要素が指定する時間内に使用可能にならない場合にTRUEです。

    タイムアウトになると、この関数は最後に変数に書き込まれた値を返し、エラーは返しません。
  • ierrcodeclst.png エラー出力

    エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。

  • iatrn.png タイムスタンプ

    タイムスタンプは、現在のデータがシェア変数に書き込まれた時間を示すタイムスタンプです。

    この出力は、変数refnumのプロパティダイアログボックスで構成ページの読み取りタイムスタンプチェックボックスがオンの場合のみ使用できます。I/O変数コンテナはタイムスタンプをサポートしていません。
  • 各変数接続は値を一度だけ新規として処理します。複数の「タイムアウト付きで変数を読み取る」関数が同じ変数接続を共有している場合、インスタンスが実行された順番に応じて各関数のインスタンスは異なる値を返します。

    注意 この関数を使用してシェア変数にアクセスすると、変数への接続が自動的に開かれます。このように間接的に接続を開くと、アプリケーションにジッタが追加される場合があります。各変数にアクセスする前に、必ず「変数接続を開く」関数を使用して変数への接続を開くことをお勧めします。