이 페이지는 기계 번역을 사용하여 번역되었습니다. 영어 원문을 보려면 여기를 클릭하십시오.
query
(삭제 예정) 계측기에 텍스트를 기록하고, 계측기에서 데이터를 읽습니다.
serial, Bluetooth, tcpip, udp, visa 및 gpib 객체 함수는 향후 릴리스에서 제거될 예정입니다. 대신 serialport, bluetooth, tcpclient, tcpserver, udpport 및 visadev 객체 함수를 사용하십시오. 코드 업데이트에 대한 자세한 내용은 버전 내역 항목을 참조하십시오.
구문
설명
out = query(obj,'cmd')는 obj에 연결된 계측기에 문자열 cmd를 기록합니다. 계측기에서 읽은 데이터는 out로 반환됩니다. 기본적으로 %s\n 형식은 cmd에 사용되며, 반환된 데이터에는 %c 형식이 사용됩니다.
out = query(obj,'cmd',wformat) 는 wformat가 지정한 형식으로 문자열 cmd를 작성합니다.
wformat는 C 언어 변환 사양입니다. 변환 사양에는 % 문자와 변환 문자 d, i, o, u, x, X, f, e, E, g, G, c, s가 포함됩니다. 자세한 내용은 sprintf 파일 입출력 형식 사양서 또는 C 매뉴얼을 참조하십시오.
out = query(obj,'cmd',wformat,rformat)는 wformat가 지정한 형식으로 문자열 cmd를 작성합니다. 계측기에서 읽은 데이터는 rformat가 지정한 형식을 사용하여 out로 반환됩니다.
rformat는 C 언어 변환 사양입니다. 지원되는 변환 사양은 wformat에서 지원하는 사양과 동일합니다.
[out,count] = query(___)는 읽은 값의 개수를 count에 반환합니다.
[out,count,msg] = query(___)는 읽기 작업이 성공적으로 완료되지 않은 경우 msg에 경고 메시지를 반환합니다.
[out,count,msg,datagramaddress,datagramport] = query(___)는 데이터그램이 발신된 원격 주소와 포트를 반환합니다. 이 값들은 UDP 객체를 사용할 때만 반환됩니다.
예제
입력 인수
| 인터페이스 객체. |
| 계측기에 기록되는 문자열. |
| 서면 데이터의 형식. |
| 읽은 데이터의 형식. |
출력 인수
| 계측기에서 읽은 데이터를 포함합니다. |
| 읽은 값의 개수. |
| 읽기 작업이 실패했는지 여부를 나타내는 메시지. |
| 데이터그램 주소. |
| 데이터그램 포트. |
팁
데이터를 쓰거나 읽기 전에, obj를 fopen 함수를 사용하여 계측기에 연결해야 합니다. 연결된 인터페이스 객체의 Status 속성 값은 open입니다. obj가 계측기에 연결되지 않은 상태에서 쿼리 작업을 수행하려고 하면 오류가 반환됩니다.
query는 동기식 모드에서만 작동하며, 쓰기 및 읽기 작업이 완료될 때까지 명령줄을 차단합니다.
query를 사용하는 것은 fprintf 및 fgets 함수를 사용하는 것과 동일합니다. 쓰기 작업을 완료하는 규칙은 fprintf 참조 페이지에 설명되어 있습니다. 읽기 작업을 완료하는 규칙은 fgets 참조 페이지에 설명되어 있습니다.
참고
함수에서 사용할 수 있는 옵션 목록을 보려면 MATLAB® 명령줄에 함수를 입력한 후 Tab 키를 누르십시오. 목록이 확장되고 스크롤하여 속성이나 값을 선택할 수 있습니다. 이 고급 탭 완성 기능을 사용하는 방법에 대한 자세한 내용은 Using Tab Completion for Functions 항목을 참조하십시오.