시스템을 쿼리하여 지정된 인터페이스와 관련된 디바이스를 찾습니다.


icon

입력/출력

  • cstr.png 식 ("?*")

    은 지정된 값을 특정 인터페이스에서 사용 가능한 디바이스와 일치시킵니다.

    지정된 설명 문자열은 기존의 디바이스에 대해 GPIB, GPIB-VXI, VXI, 모든 VXI, 시리얼, 또는 모든 인터페이스를 검색하기 위한 기준을 설정합니다. 다음 테이블은 유효한 특수 문자와 연산자를 포함합니다.

    특수 문자와 연산자의미
    ?모든 단일 문자와 일치합니다.
    \다음에 따라오는 문자를 특수 문자가 아닌 일반 문자로 사용합니다. 예를 들어, 물음표가 백슬래쉬 뒤에 따라올 경우 (\?), 모든 단일 문자 대신에 ? 문자와 일치합니다.
    [list]둘러싸인 리스트의 모든 단일 문자와 일치합니다. 문자의 범위와 일치하도록 하이픈을 사용할 수 있습니다.
    [^list]포함된 리스트에 없는 모든 문자와 일치합니다. 문자의 범위와 일치하도록 하이픈을 사용할 수 있습니다.
    *이전 문자 또는 식의 0 또는 그 이상의 발생과 일치합니다.
    +이전 문자 또는 식의 1 또는 그 이상의 발생과 일치합니다.
    식|식이전 또는 다음의 식과 일치합니다. OR 연산자 | 는 식의 이전 또는 다음에 오는 문자가 아닌 전체 식과 일치합니다. 예를 들어, VXI|GPIB는 VX(I|G)PIB가 아닌, (VXI)|(GPIB)를 의미합니다.
    (식)문자 또는 식을 하나로 묶습니다.

    파라미터에 지정된 검색 기준은 두 부분, 리소스 문자열에 관한 정규식과 속성 값에 관한 선택적인 논리식을 가집니다. 정규식은 VISA 리소스 관리자로 알려진 리소스의 리소스 문자열에 대해서 일치됩니다. 리소스 문자열이 정규식과 일치하지 않을 경우, 리소스의 속성 값은 속성 값에 관한 식에 대해서 일치됩니다. 일치가 성공적인 경우, 리소스는 검색 기준을 만족했으며 발견된 리소스의 리스트에 추가됩니다. 다음 테이블은 유효한 정규식을 나타냅니다.

    정규식일치하는 샘플
    GPIB?*INSTRGPIB0::2::INSTR, GPIB1::1::1::INSTR, GPIB-VXI1::8::INSTR과 일치합니다.
    GPIB[0-9]*::?*INSTRGPIB0::2::INSTR, GPIB1::1::1::INSTR과는 일치하지만 GPIB-VXI1::8::INSTR과는 일치하지 않습니다.
    GPIB[^0]::?*INSTRGPIB1::1::1::INSTR과는 일치하지만 GPIB0::2::INSTR 또는 GPIB12::8::INSTR과는 일치하지 않습니다.
    VXI?*INSTRVXI0::1::INSTR과는 일치하지만 GPIB-VXI0::1::INSTR과는 일치하지 않습니다.
    GPIB-VXI?*INSTRGPIB-VXI0::1::INSTR과는 일치하지만 VXI0::1::INSTR과는 일치하지 않습니다.
    ?*VXI[0-9]*::?*INSTRVXI0::1::INSTRGPIB-VXI0::1::INSTR과 일치합니다.
    ASRL[0-9]*::?*INSTRASRL1::INSTR과는 일치하지만 VXI0::5::INSTR과는 일치하지 않습니다.
    ASRL1+::INSTRASRL1::INSTRASRL11::INSTR과는 일치하지만 ASRL2::INSTR과는 일치하지 않습니다.
    (GPIB|VXI)?*INSTRGPIB1::5::INSTRVXI0::3::INSTR과는 일치하지만 ASRL2::INSTR과는 일치하지 않습니다.
    (GPIB0|VXI0)::1::INSTRGPIB0::1::INSTRVXI0::1::INSTR과 일치합니다.
    ?*INSTR모든 INSTR (디바이스) 리소스와 일치합니다.
    ?*VXI[0-9]*::?*MEMACCVXI0::MEMACCGPIB-VXI1::MEMACC과 일치합니다.
    VXI0::?*VXI0::1::INSTR, VXI0::2::INSTRVXI0::MEMACC과 일치합니다.
    ?*(기본) 모든 리소스와 일치합니다.
    visa://hostname/?*지정된 원격 시스템의 모든 리소스와 일치합니다. 호스트 이름은 IP 주소 (점 표기) 또는 네트워크 컴퓨터 이름으로 설정할 수 있습니다. 이 원격 시스템은 설정된 원격 시스템일 필요는 없습니다.
    /?*로컬 머신의 모든 리소스와 일치합니다. 설정된 원격 시스템을 쿼리하지 않습니다.
    visa:/ASRL?*INSTR로컬 머신의 모든 ASRL 리소스와 일치하며 이를 visa:/ASRL1::INSTR)URL과 같은 포맷으로 반환합니다.

    선택적인 속성 식을 사용하여, 논리적 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 인스트루먼트 리소스를 찾습니다.
  • cu32.png 검색 모드(0)

    검색 모드는 함수가 어떻게 발견된 인터페이스를 찾은 리스트에 반환하는지 여부를 표준 이름 또는 가명으로 결정합니다. 기본은 0입니다.

    이 입력은 다음 값을 받습니다.

    0표준 이름만―모든 설정된 버스를 검색합니다. 식 문자열과 일치하는 발견된 리소스만을 반환합니다. 각 반환된 문자열의 포맷은 VISA 표준으로 스펙 정의된 리소스 포맷입니다.
    2가명만―모든 설정된 버스를 검색합니다. 식 문자열과 일치하는 발견된 리소스만을 반환합니다. 각 리소스에서, 리소스에 대한 사용자 정의 가명이 있는 경우 가명이 반환됩니다. 다른 리소스에서 반환된 문자열은 VISA 표준으로 스펙 정의된 리소스 포맷입니다.
    3일치하는 가명 포함―어떠한 버스도 검색하지 않습니다. 사용자 정의 가명을 가지는 리소스만을 반환합니다. 유일한 유효한 식 문자열은 "?*"입니다. 각 반환된 문자열의 포맷은 가명입니다.
    4모든 가명 포함―모든 설정된 버스를 검색합니다. 식 문자열과 일치하는 모든 발견된 리소스와 더불어 비록 식 문자열과 일치하지 않더라도 모든 사용자 정의 가명을 반환합니다. 각 리소스에서, 함수는 리소스에 하나의 사용자 정의 가명이 있을 때 사용자 정의 가명을 반환합니다. 다른 리소스에서 반환된 문자열은 VISA 표준으로 스펙 정의된 리소스 포맷입니다.
  • cerrcodeclst.png 에러 입력(에러 없음)

    에러 입력은 이 노드의 실행 전에 발생한 에러 조건을 설명합니다. 이 입력은 표준 에러 입력 기능을 제공합니다.

  • i1dstr.png 찾은 리스트

    찾은 리스트는 각 문자열이 함수에 의해 발견된 하나의 인터페이스를 나타내는 문자열의 배열입니다.

  • iu32.png 반환 카운트

    반환 카운트는 발견된 일치의 개수를 나타냅니다. 발견된 일치의 개수는 찾기 리스트 배열의 문자열 개수입니다.

  • ierrcodeclst.png 에러 출력

    에러 출력은 에러 정보를 포함합니다. 이 출력은 표준 에러 출력 기능을 제공합니다.

  • LabVIEW는 선택된 I/O 컨트롤 클래스 타입과 필터 VISA 이름 대화 상자에 따라 I/O 컨트롤의 리소스를 나열하므로, 이 함수의 호출은 필수적이지는 않습니다.

    이 함수가 반환한 모든 리소스 문자열은 [VISA 열기]로 인식됩니다. 그러나, 이 함수는 [VISA 열기] 함수에 전달한 문자열을 모두 반환하지 않을 수도 있습니다. 특히 네트워크와 TCP/IP 리소스의 경우가 이에 해당됩니다. 리소스가 목록에 나타나지 않는 경우 (Windows) 측정 및 자동화 탐색기, (Linux) visaconf 또는 (Mac OS X) NI-VISA 구성과 같은 NI-VISA 구성 유틸리티에서 해당 리소스를 명시적으로 추가할 수 있습니다. 또한 설정 유틸리티에는 이 VI가 반환하는 리소스의 세트를 확장하거나 제한하는 옵션이 있습니다.