搜索变量容器函数
- 更新时间2025-07-30
- 阅读时长4分钟
搜索变量容器,返回满足搜索条件的变量对象的引用数组。使用该函数可通过编程查找变量。
搜索条件为可选。如存在未连线的搜索条件输入接线端,函数不按照条件进行搜索。

输入/输出
类
—
容器引用句柄输入
—
容器引用句柄输入指定要搜索的变量容器。该函数可搜索指定容器中的全部容器层次结构。 该函数可搜索指定容器中全部变量的部分URL。但是,部分URL不包括对应于该容器的URL。
正则表达式
—
数据类型
—
数据类型指定要搜索的共享变量的数据类型。默认值为变量,即如果终端未接线,函数不会根据数据类型进行过滤。然而,如果连线变体控件或常量至该接线端,函数仅返回变体数据类型的变量。
错误输入
—
错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。
访问类型
—
访问类型指定要搜索的共享变量的读取和写入访问类型。默认值为允许读取和写入访问。
容器引用句柄输出
—
容器引用句柄输出是连线至容器引用句柄输入的共享变量容器的引用。
引用句柄数组输出
—
引用句柄数组输出包含搜索到的变量对象引用。
错误输出
—
错误输出包含错误信息。该输出提供标准错误输出功能。 |
搜索结果匹配指定正则表达式的变量对象的部分变量标识符URL,变量对象属于指定的变量容器。部分URL忽略初始URL子字符串(对应于连线至容器引用输入的URL)。
例如,如连线URL ni.var.psp://lib1至容器引用句柄输入,则URL为ni.var.psp://lib1/lib2/var1的变量对象的部分URL为lib2/var1。
类
—
正则表达式
—
数据类型
—
错误输入
—
访问类型
—
Read Access
—
容器引用句柄输出
—
引用句柄数组输出
—
错误输出
—