変数コンテナを検索関数
- 更新日2025-07-30
- 5分で読める
変数コンテナの下を検索し、変数オブジェクトに検索条件と一致するリファレンスの配列を返します。この関数を使用して変数をプログラム的に検索できます。
すべての検索条件はオプションです。検索条件入力端子を未配線にすると、この関数はその条件に基づいたフィルタを実行しません。

入力/出力
クラス
—
コンテナrefnum入力
—
コンテナrefnum入力は、検索する変数コンテナを指定します。この関数は、指定したコンテナの下で完全なコンテナ階層を検索します。 この関数は、指定したコンテナの下ですべての変数の部分的なURLを検索します。部分的なURLには、このコンテナに対応するURLは含まれません。
正規表現
—
正規表現は、変数オブジェクトURL内で検索するパターンです。デフォルトは空の文字列です。 この関数は Match Regular Expression 関数と同じ 正規表現ルールを 使用します。
データタイプ
—
データタイプは、検索するシェア変数のデータタイプを指定します。デフォルトはvariantであり、端末を未配線のままにしておくと、この関数はデータ型に基づくフィルタリングを行わない。ただし、バリアント制御器または定数をこの端子に配線すると、関数はそのバリアントデータタイプの変数だけを返します。
エラー入力
—
エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。
アクセスタイプ
—
アクセスタイプは、検索するシェア変数の読み取りアクセスおよび書き込みアクセスの設定を指定します。デフォルト値は、読み取りアクセスと書き込みアクセスの両方で許可です。
コンテナrefnum出力
—
コンテナrefnum出力は、コンテナrefnum入力に書き込むシェア変数コンテナへのリファレンスです。
refnum配列出力
—
refnum配列出力には、検索による変数オブジェクトリファレンスが含まれます。
エラー出力
—
エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。 |
検索では、指定した正規表現を、指定した変数コンテナの下にあるすべての変数オブジェクトの部分的な変数識別子URLと一致させます。部分的なURLには、コンテナrefnum入力に接続されたURLの冒頭のURL部分文字列が含まれません。
たとえば、コンテナrefnum入力にni.var.psp://lib1というURLを配線した場合、ni.var.psp://lib1/lib2/var1というURLの変数オブジェクトの部分URLは、lib2/var1となります。
クラス
—
正規表現
—
データタイプ
—
エラー入力
—
アクセスタイプ
—
Read Access
—
コンテナrefnum出力
—
refnum配列出力
—
エラー出力
—