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'인 객체를 찾습니다.

버전 내역

모두 확장

참고 항목

함수