搜索变量容器,返回满足搜索条件的变量对象的引用数组。使用该函数可通过编程查找变量。

搜索条件为可选。如存在未连线的搜索条件输入接线端,函数不按照条件进行搜索。


icon

输入/输出

  • cgenclassrntag.png

    指定要搜索的变量对象所属的。默认值为变量对象

  • cgenclassrntag.png 容器引用句柄输入

    容器引用句柄输入指定要搜索的变量容器。该函数可搜索指定容器中的全部容器层次结构。

    该函数可搜索指定容器中全部变量的部分URL。但是,部分URL不包括对应于该容器的URL。

  • cstr.png 正则表达式

    正则表达式指定在变量对象URL中搜索的模式。默认为空字符串。

    该函数使用与 匹配正则表达式 函数相同的 正则表达式 规则

  • cfxdt.png 数据类型

    数据类型指定要搜索的共享变量的数据类型。默认值为变量,即如果终端未接线,函数不会根据数据类型进行过滤。然而,如果连线变体控件或常量至该接线端,函数仅返回变体数据类型的变量。

  • cerrcodeclst.png 错误输入

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • cnclst.png 访问类型

    访问类型指定要搜索的共享变量的读取和写入访问类型。默认值为允许读取和写入访问。

  • cenum.png Read Access

    读取访问指定依据读取访问过滤共享变量。

    0Allowed-依据读取访问不执行滤波。
    1Required-返回允许读取的共享变量。
    2Denied-返回禁止读取的共享变量。
  • cenum.png Write Access

    写入访问指定依据写入访问过滤共享变量。

    0Allowed-依据写入访问不执行滤波。
    1Required-返回允许写入的共享变量。
    2Denied-返回禁止写入的共享变量。
  • igenclassrntag.png 容器引用句柄输出

    容器引用句柄输出是连线至容器引用句柄输入的共享变量容器的引用。

  • i1dgenclassrntag.png 引用句柄数组输出

    引用句柄数组输出包含搜索到的变量对象引用。

  • ierrcodeclst.png 错误输出

    错误输出包含错误信息。该输出提供标准错误输出功能。

  • 搜索结果匹配指定正则表达式的变量对象的部分变量标识符URL,变量对象属于指定的变量容器。部分URL忽略初始URL子字符串(对应于连线至容器引用输入的URL)。

    例如,如连线URL ni.var.psp://lib1容器引用句柄输入,则URL为ni.var.psp://lib1/lib2/var1的变量对象的部分URL为lib2/var1