instrfindall
(제거될 예정임) 표시된 또는 숨겨진 직렬 포트 객체 찾기
이 serial
객체 함수는 향후 릴리스에서 제거될 예정입니다. serialport
객체 함수를 대신 사용하십시오. 코드 업데이트에 대한 자세한 내용은 호환성 관련 고려 사항 항목을 참조하십시오.
구문
out = instrfindall
out = instrfindall('P1
',V1,...)
out = instrfindall(s)
out = instrfindall(objs,'P1
',V1,...)
설명
out = instrfindall
은 객체의 ObjectVisibility
속성값에 관계없이 모든 직렬 포트 객체를 찾습니다. 찾아진 객체는 out
으로 반환됩니다.
out = instrfindall('
는 속성 이름과 이에 대응하는 속성값이 인수로 지정된 이름 및 값과 일치하는 직렬 포트 객체로 구성된 배열 P1
',V1,...)out
을 반환합니다.
out = instrfindall(s)
는 속성 이름과 이에 대응하는 속성값이 구조체 s
에 지정된 이름 및 값과 일치하는 직렬 포트 객체로 구성된 배열 out
을 반환합니다. 여기서 필드 이름은 속성 이름에 대응하고, 필드 값은 각 속성의 현재 값에 대응합니다.
out = instrfindall(objs,'
은 일치하는 속성 이름/속성값 쌍을 가진 객체에 대한 검색을 P1
',V1,...)objs
에 나열된 직렬 포트 객체로 제한합니다.
참고로, instrfindall
에 대한 동일한 호출에서 문자열 속성 이름/속성값 쌍, 구조체 및 셀형 배열 속성 이름/속성값 쌍을 사용할 수 있습니다.
예제
Windows® 플랫폼에서 다음과 같은 직렬 포트 객체를 생성한다고 가정합니다.
s1 = serial('COM1'); s2 = serial('COM2'); set(s2,'ObjectVisibility','off')
객체 s2
의 ObjectVisibility
가 'off'
로 설정되어 있기 때문에 instrfind
와 같은 명령에는 보이지 않습니다.
instrfind
Serial Port Object : Serial-COM1
하지만 instrfindall
는 ObjectVisibility
의 값에 관계없이 모든 객체를 찾습니다.
instrfindall
Instrument Object Array Index: Type: Status: Name: 1 serial closed Serial-COM1 2 serial closed Serial-COM2
다음 명령문은 셀형 배열로 전달되는 특정한 속성 설정을 가진 객체를 반환하도록 instrfindall
을 사용합니다.
props = {'PrimaryAddress','SecondaryAddress}; vals = {2,0}; obj = instrfindall(props,vals);
표시되거나 숨겨진 모든 객체에 이 명령을 적용하려는 경우 instrfindall
을 인수로 사용할 수 있습니다. 예를 들어, 다음 명령문은 모든 객체를 표시합니다.
set(instrfindall,'ObjectVisibility','on')
팁
instrfindall
은 ObjectVisibility
속성이 off
로 설정된 객체를 찾는다는 점에서 instrfind
와 다릅니다.
속성값은 대/소문자를 구분합니다. get
함수가 반환한 형식과 동일한 형식을 사용하여 속성값을 지정해야 합니다. 예를 들어, get
이 Name
속성값을 'MyObject'
로 반환하는 경우, instrfindall
는 Name
속성값이 'myobject'
인 객체를 찾지 않습니다. 그러나 이는 유한한 문자열 값 세트를 가진 속성에는 해당되지 않습니다. 예를 들어, instrfindall
는 Parity
속성값이 'Even'
또는 'even'
인 객체를 찾습니다.