Main Content

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

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

버전 내역

모두 축소

R2021a: serial 객체 인터페이스는 제거될 예정임

이 함수를 serial 객체와 함께 사용하는 것은 제거될 예정입니다. 직렬 포트 장치에 액세스하려면 대신 serialport 객체를 해당 함수 및 속성과 함께 사용하십시오.

권장되는 기능은 추가 기능과 성능 향상을 제공합니다. 권장되는 기능의 사용 방법에 대한 자세한 내용은 코드를 serialport 인터페이스로 전환하기 항목을 참조하십시오.

참고 항목

함수