VISA查找资源函数

表达式匹配由特定接口的可用设备指定的值。

说明字符串指定用于搜索已有设备接口（GPIB、GPIB-VXI、VXI、所有VXI、串行或所有）的标准。下表包含有效的字符和运算符。

特殊字符和操作符	含义
?	匹配任意字符。
\	使后续字符为普通字符而非特殊字符。例如，当反斜扛后跟随问号（\?）时，匹配的是？字符而非其他字符。
[list]	匹配来自列表的任意字符。连字符用于匹配一定范围的字符。
[^list]	匹配任意不在列表中的字符。连字符用于匹配一定范围的字符。
*	匹配0个或多个先前出现的字符或表达式。
+	匹配1个或多个先前出现的字符或表达式。
表达式|表达式	匹配先前的或后续的表达式，而非先前的或后续的字符。例如，VXI|GPIB的含义是(VXI)|(GPIB)，而非VX(I|G)PIB。
(exp)	对字符或表达式分组。

表达式参数指定的搜索标准有两个部分，一个关于资源字符串的正则表达式，另一个关于属性值的可选逻辑表达式。正则表达式不匹配VISA资源管理器已知资源的资源字符串。如资源字符串匹配正则表达式，资源的属性值不匹配关于属性值的表达式。如匹配成功，资源满足搜索标准并已加入至已找到资源的列表中。下表包含有效的正则表达式。

正则表达式	采样匹配
GPIB?*INSTR	匹配GPIB0::2::INSTR、GPIB1::1::1::INSTR和GPIB-VXI1::8::INSTR。
GPIB[0-9]*::?*INSTR	匹配GPIB0::2::INSTR、GPIB1::1::1::INSTR，不匹配GPIB-VXI1::8::INSTR。
GPIB[^0]::?*INSTR	匹配GPIB1::1::1::INSTR，但不匹配GPIB0::2::INSTR或 GPIB12::8::INSTR。
VXI?*INSTR	匹配VXI0::1::INSTR，但不匹配GPIB-VXI0::1::INSTR。
GPIB-VXI?*INSTR	匹配GPIB-VXI0::1::INSTR，但不匹配VXI0::1::INSTR。
?*VXI[0-9]*::?*INSTR	匹配VXI0::1::INSTR以及GPIB-VXI0::1::INSTR。
ASRL[0-9]*::?*INSTR	匹配ASRL1::INSTR，但不匹配VXI0::5::INSTR。
ASRL1+::INSTR	匹配ASRL1::INSTR和ASRL11::INSTR，但不匹配ASRL2::INSTR。
(GPIB|VXI)?*INSTR	匹配GPIB1::5::INSTR和VXI0::3::INSTR，但不匹配ASRL2::INSTR。
(GPIB0|VXI0)::1::INSTR	匹配GPIB0::1::INSTR和VXI0::1::INSTR。
?*INSTR	匹配所有INSTR（设备）资源。
?*VXI[0-9]*::?*MEMACC	匹配VXI0::MEMACC和GPIB-VXI1::MEMACC。
VXI0::?*	匹配VXI0::1::INSTR、VXI0::2::INSTR和VXI0::MEMACC。
?*	（默认）匹配所有资源。
visa://主机名/?*	在远程系统上的资源。主机名可以是IP地址（点表示法）或网络机器名。远程系统无需为已配置的远程系统。
/?*	匹配本地机器上的所有资源。不查询已配置的远程系统。
visa:/ASRL?*INSTR	匹配本地机器上的所有ASRL资源并以URL格式返回（例如，visa:/ASRL1::INSTR）。

通过使用可选属性表达式，可用逻辑AND()、OR(||)、NOT(！)构造功能更强大的表达式。等于(==)和不等于(!=)比较符用于比较任意数据类型的属性，其他的不相等比较符（如>、<、>=、<=）用于比较数值数据类型的属性。在属性表达式中只能使用全局属性。局部属性不能出现在表达式参数的逻辑表达式部分。下表包含有效的表达式参数。

表达式参数	含义
GPIB[0-9]*::?*::?*::INSTR{VI_ATTR_GPIB_SECONDARY_ADDR > 0 && VI_ATTR_GPIB_SECONDARY_ADDR < 10}	查找次地址为1至9的GPIB设备。
ASRL?*INSTR{VI_ATTR_ASRL_BAUD == 9600}	查找所有配置为9600波特的串口。
?*VXI?INSTR{VI_ATTR_MANF_ID == 0xFF6 && !(VI_ATTR_VXI_LA ==0 || VI_ATTR_SLOT <= 0)}	查找所有制造商ID为FF6且不是逻辑地址0、插槽0或外部控制器的VXI仪器资源。

搜索模式确定函数如何返回通过规范名称或别名在查找列表输出中找到的接口。默认值为0。

该输入支持下列值。

0	仅允许规范名称－查找所有已配置的总线。只返回查找到的与表达式字符串匹配的资源。每个返回字符串的格式是VISA规范指定的资源格式。
2	只允许别名－查找所有已配置的总线。只返回查找到的与表达式字符串匹配的资源。对于每个资源，如有用户定义的别名，则返回该别名。对于其它资源，返回字符串的格式是VISA规范指定的资源格式。
3	包含匹配别名—不查找任何总线。只返回有用户定义别名的资源。唯一有效的表达式字符串是"?*"。每个返回的字符串的格式是一个别名。
4	包含所有别名—查找所有已配置的总线。返回所有查找到的与表达式字符串匹配的资源以及所有用户自定义的别名（即使不匹配表达式字符串）。对于每个资源，如资源有用户自定义的别名，则函数返回该别名。对于其它资源，返回字符串的格式是VISA规范指定的资源格式。

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

查找列表该字符串数组中的每个字符串指定函数找到的一个接口。

返回数指定找到的匹配的数量。找到的匹配的数量是查找列表数组中字符串的数量。

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