이 페이지의 최신 내용은 아직 번역되지 않았습니다. 최신 내용은 영문으로 볼 수 있습니다.

instrfindall

표시된 또는 숨겨진 직렬 포트 객체 찾기

구문

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')

객체 s2ObjectVisibility'off'로 설정되어 있기 때문에 instrfind와 같은 명령에는 보이지 않습니다.

instrfind
   Serial Port Object : Serial-COM1

하지만 instrfindallObjectVisibility의 값에 관계없이 모든 객체를 찾습니다.

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')

instrfindallObjectVisibility 속성이 off로 설정된 객체를 찾는다는 점에서 instrfind와 다릅니다.

속성값은 대/소문자를 구분합니다. get 함수가 반환한 형식과 동일한 형식을 사용하여 속성값을 지정해야 합니다. 예를 들어, getName 속성값을 'MyObject'로 반환하는 경우, instrfindallName 속성값이 'myobject'인 객체를 찾지 않습니다. 그러나 이는 유한한 문자열 값 세트를 가진 속성에는 해당되지 않습니다. 예를 들어, instrfindallParity 속성값이 'Even' 또는 'even'인 객체를 찾습니다.

참고 항목

| |