변수 컨테이너를 검색하여 검색 조건에 맞는 변수 객체의 참조 배열을 반환합니다. 이 함수를 사용하여 프로그램적으로 변수를 찾을 수 있습니다.

모든 검색 기준은 옵션입니다. 검색 기준 입력 터미널을 연결하지 않는 경우, 이 함수는 해당 기준을 바탕으로 필터링을 하지 않습니다.


icon

입력/출력

  • cgenclassrntag.png 클래스

    클래스는 검색하려는 변수 객체의 클래스를 지정합니다. 기본은 변수 객체입니다.

  • cgenclassrntag.png 컨테이너 참조 번호 입력

    컨테이너 참조 번호 입력은 검색하려는 변수 컨테이너를 지정합니다. 이 함수는 지정하는 컨테이너 아래의 전체 컨테이너 계층구조를 검색합니다.

    이 함수는 지정한 컨테이너 아래에 있는 모든 변수의 부분 URL을 검색합니다. 부분 URL에는 이 컨테이너에 대응하는 URL이 포함되지 않습니다.

  • cstr.png 정규식

    정규식은 변수 객체 URL 내에서 검색하려는 패턴입니다. 기본값은 빈 문자열입니다.

    이 함수는 정규식 일치 함수와 동일한 정규식 규칙을 사용합니다.

  • cfxdt.png 데이터 타입

    데이터 타입은 검색하려는 공유 변수의 데이터 타입을 지정합니다. 기본값은 variant로, 터미널을 연결하지 않은 상태로 두면 함수가 데이터 유형에 따라 필터링하지 않도록 지정합니다. 그러나 배리언트 컨트롤 또는 상수를 이 터미널에 연결하는 경우, 이 함수는 배리언트 데이터 타입의 변수만 반환합니다.

  • 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 부분 문자열을 포함하지 않습니다.

    예를 들어 ni.var.psp://lib1 URL을 컨테이너 참조 번호 입력에 연결하는 경우, URL ni.var.psp://lib1/lib2/var1을 가진 변수 객체의 부분 URL은 lib2/var1이 됩니다.