変数コンテナの下を検索し、変数オブジェクトに検索条件と一致するリファレンスの配列を返します。この関数を使用して変数をプログラム的に検索できます。

すべての検索条件はオプションです。検索条件入力端子を未配線にすると、この関数はその条件に基づいたフィルタを実行しません。


icon

入力/出力

  • cgenclassrntag.png クラス

    クラスは、検索する変数オブジェクトのクラスを指定します。デフォルトは変数オブジェクトです。

  • cgenclassrntag.png コンテナrefnum入力

    コンテナrefnum入力は、検索する変数コンテナを指定します。この関数は、指定したコンテナの下で完全なコンテナ階層を検索します。

    この関数は、指定したコンテナの下ですべての変数の部分的なURLを検索します。部分的なURLには、このコンテナに対応するURLは含まれません。

  • cstr.png 正規表現

    正規表現は、変数オブジェクトURL内で検索するパターンです。デフォルトは空の文字列です。

    この関数は Match Regular Expression 関数と同じ 正規表現ルールを 使用します。

  • cfxdt.png データタイプ

    データタイプは、検索するシェア変数のデータタイプを指定します。デフォルトはvariantであり、端末を未配線のままにしておくと、この関数はデータ型に基づくフィルタリングを行わない。ただし、バリアント制御器または定数をこの端子に配線すると、関数はそのバリアントデータタイプの変数だけを返します。

  • cerrcodeclst.png エラー入力

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

  • cnclst.png アクセスタイプ

    アクセスタイプは、検索するシェア変数の読み取りアクセスおよび書き込みアクセスの設定を指定します。デフォルト値は、読み取りアクセスと書き込みアクセスの両方で許可です。

  • cenum.png Read Access

    読み取りアクセスは、読み取りアクセスにおけるシェア変数のフィルタオプションを指定します。

    0Allowed―読み取りアクセスに基づいたフィルタ処理を実行しません。
    1Required―読み取りアクセスが有効にされたシェア変数だけを返します。
    2Denied―読み取りアクセスが無効にされたシェア変数だけを返します。
  • cenum.png Write Access

    書き込みアクセスは、書き込みアクセスにおけるシェア変数のフィルタオプションを指定します。

    0Allowed―書き込みアクセスに基づいたフィルタ処理を実行しません。
    1Required―書き込みアクセスが有効にされたシェア変数だけを返します。
    2Denied―書き込みアクセスが無効にされたシェア変数だけを返します。
  • igenclassrntag.png コンテナrefnum出力

    コンテナrefnum出力は、コンテナrefnum入力に書き込むシェア変数コンテナへのリファレンスです。

  • i1dgenclassrntag.png refnum配列出力

    refnum配列出力には、検索による変数オブジェクトリファレンスが含まれます。

  • ierrcodeclst.png エラー出力

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

  • 検索では、指定した正規表現を、指定した変数コンテナの下にあるすべての変数オブジェクトの部分的な変数識別子URLと一致させます。部分的なURLには、コンテナrefnum入力に接続されたURLの冒頭のURL部分文字列が含まれません。

    たとえば、コンテナrefnum入力ni.var.psp://lib1というURLを配線した場合、ni.var.psp://lib1/lib2/var1というURLの変数オブジェクトの部分URLは、lib2/var1となります。