매개변수
개요
- 컴포넌트, 풋프린트 또는 일반 PCB 객체에 적용되는 파라미터 쿼리 키워드와 각 키워드를 필터나 쿼리에서 사용하는 방법을 알아보세요.
- 파라미터 이름으로 객체를 찾고, 값의 전체 또는 일부가 일치하는 객체를 검색하며, 조건에 맞지 않는 객체를 제외하는 쿼리 예제를 살펴보세요.
- 'StrToNumber', 'StrToNumberDef' 등의 키워드를 사용하여 문자열 형식의 파라미터 값을 숫자로 변환하고 범위를 기준으로 비교하는 방법을 이해해 보세요.

Query Helper 대화 상자에 표시된 Parameters PCB 쿼리 함수
이 참조 페이지에서는 PCB 및 PCB 라이브러리 문서에서 사용할 수 있는 Parameters 범주의 쿼리 언어 키워드를 자세히 설명합니다. 특정 쿼리 키워드에 대한 도움말을 보려면 아래의 접을 수 있는 섹션을 사용하거나, Query Helper 또는 Filter Panel에서 해당 키워드를 선택하거나 키워드 내부를 클릭한 다음 F1 키를 눌러 해당 섹션으로 바로 이동하세요.
CompParameterValue
요약
PCB 컴포넌트 파라미터의 문자열 값을 반환합니다. 이 값을 검사하여 쿼리 조건을 충족하는 PCB 컴포넌트를 반환할 수 있습니다.
구문
CompParameterValue(ParameterName : String) : String
사용 예
CompParameterValue('Mounting Technology') Like 'SM*'
SM로 시작하는 문자열 값(예: SMT, SMD 등)을 가진 Mounting Technology 파라미터를 포함하는 모든 컴포넌트를 반환합니다. 조건을 충족하는 컴포넌트 객체에 연결된 트랙, 원호, 패드, 텍스트 등의 하위 객체도 반환됩니다.
CompParameterValue('Mounting Technology') Like '*SM*'
Mounting Technology 파라미터의 문자열 값에 *SM*이 포함된 모든 컴포넌트와 연결된 하위 객체를 반환합니다.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
VoltageRating 파라미터 값이 50볼트보다 큰 모든 컴포넌트와 연결된 하위 객체를 반환합니다. CompParameterValue에서 반환된 문자열 값은 단위를 인식하는 StrToNumber 함수에 의해 비교를 위한 숫자로 변환됩니다.
FootprintParameterValue
요약
PCB 풋프린트 파라미터의 문자열 값을 반환합니다. 이 값을 검사하여 쿼리 조건을 충족하는 PCB 컴포넌트를 반환할 수 있습니다.
구문
FootprintParameterValue(ParameterName : String) : String
사용 예
FootprintParameterValue('Mounting Type') Like 'SMD'
Mounting Type 풋프린트 파라미터의 문자열 값에 SMD이 포함된 모든 컴포넌트와 연결된 하위 객체를 반환합니다.
HasCompParameter
요약
지정된 이름의 파라미터를 포함하는 PCB 컴포넌트를 반환합니다.
구문
HasCompParameter(ParameterName : String) : Boolean
사용 예
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
Mounting Technology 이름의 파라미터가 있는 모든 컴포넌트 Parent 객체를 반환합니다. 조건을 충족하는 컴포넌트 객체에 연결된 트랙, 원호, 패드, 텍스트 등의 하위 객체도 반환됩니다.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Mounting Technology 파라미터가 있는 컴포넌트 Parent 객체에 대해 except 모든 컴포넌트와 연결된 하위 객체를 반환합니다.
HasCompParameterValue
요약
지정된 이름의 파라미터를 포함하며 해당 파라미터 값이 쿼리 조건을 충족하는 PCB 컴포넌트를 반환합니다.
구문
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
사용 예
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Mounting Technology 이름의 파라미터가 있고 그 값 속성이 SMT과 일치하는 모든 컴포넌트 Parent 객체를 반환합니다. 조건을 충족하는 컴포넌트 객체에 연결된 트랙, 원호, 패드, 텍스트 등의 하위 객체도 반환됩니다.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
값이 RoHS-Compliant인 Design Item Status 파라미터가 없는 모든 컴포넌트와 연결된 하위 객체를 반환합니다.
HasFootprintParameter
요약
지정된 이름의 풋프린트 파라미터를 포함하는 PCB 컴포넌트를 반환합니다.
구문
HasFootprintParameter(ParameterName : String) : Boolean
사용 예
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
IPC Density 이름의 풋프린트 파라미터가 있는 모든 컴포넌트 Parent 객체를 반환합니다. 조건을 충족하는 컴포넌트 객체에 연결된 트랙, 원호, 패드, 텍스트 등의 하위 객체도 반환됩니다.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
IPC Density 풋프린트 파라미터가 있는 컴포넌트 Parent 객체에 대해 except 모든 컴포넌트와 연결된 하위 객체를 반환합니다.
HasFootprintParameterValue
요약
지정된 이름의 풋프린트 파라미터를 포함하며 해당 파라미터 값이 쿼리 조건을 충족하는 PCB 컴포넌트를 반환합니다.
구문
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
사용 예
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Mounting Method 이름의 풋프린트 파라미터가 있고 그 값 속성이 Press Fit. 와 일치하는 모든 컴포넌트 Parent 객체를 반환합니다. 조건을 충족하는 컴포넌트 객체에 연결된 트랙, 원호, 패드, 텍스트 등의 하위 객체도 반환됩니다.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
Mounting Method 풋프린트 파라미터의 값이 Press Fit.
HasParameter
요약
지정된 이름의 파라미터를 포함하는 PCB 객체를 반환합니다.
구문
HasParameter(ParameterName : String) : Boolean
사용 예
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
Mounting Technology 이름의 파라미터가 있는 모든 객체를 반환합니다.
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
Mounting Technology 파라미터가 있는 객체를 except 모든 객체를 반환합니다.
HasParameterValue
요약
지정된 이름의 파라미터를 포함하며 해당 파라미터 값이 쿼리 조건을 충족하는 PCB 객체를 반환합니다.
구문
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
사용 예
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
Mounting Technology 이름의 파라미터가 있고 그 값 속성이 SMT과 일치하는 모든 객체를 반환합니다.
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
값이 RoHS-Compliant인 Design Item Status 파라미터가 없는 모든 객체를 반환합니다.
ParameterValue
요약
PCB 객체 파라미터의 문자열 값을 반환합니다. 이 값을 검사하여 쿼리 조건을 충족하는 PCB 객체를 반환할 수 있습니다.
구문
ParameterValue(ParameterName : String) : String
사용 예
ParameterValue('Mounting Technology') Like 'SM*'
SM로 시작하는 문자열 값(예: SMT, SMD 등)을 가진 Mounting Technology 파라미터가 있는 모든 객체를 반환합니다.
ParameterValue('Mounting Technology') Like '*SM*'
Mounting Technology 파라미터의 문자열 값에 SM이 포함된 모든 객체를 반환합니다.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
VoltageRating 파라미터 값이 50볼트보다 큰 모든 객체를 반환합니다. ParameterValue에서 반환된 문자열 값은 단위를 인식하는 StrToNumber 함수에 의해 비교를 위한 숫자로 변환됩니다.
StrToNumber
요약
지정된 단위 유형을 사용하여 지정한 파라미터 값 문자열을 숫자로 변환합니다.
구문
StrToNumber(Value : String , Unit : String) : Number
사용 예
StrToNumber(ParameterValue('VoltageRating'),V) > 50
볼트(V)를 단위로 사용하여 VoltageRating 파라미터에서 반환된 값 문자열을 숫자로 변환한 다음, 값이 50V보다 큰 모든 객체를 반환합니다.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
옴을 단위로 사용하여 Resistance 파라미터에서 반환된 값 문자열을 숫자로 변환한 다음, 값이 1kΩ과 10kΩ 사이인 모든 객체를 반환합니다.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
정전 용량 단위(F)를 사용하여 CapacitanceValue 파라미터에서 반환된 값 문자열을 숫자로 변환한 다음, 값이 2nF(과학적 표기법으로 2e-9)보다 작은 모든 객체를 반환합니다.
참고
값 문자열을 숫자로 변환할 수 없으면 스크립팅 오류가 발생합니다. 이러한 상황에 대비하려면 변환에 실패할 경우 지정된 Default 숫자를 반환하는 StrToNumber 함수를 사용하세요.
단위를 인식하는 문자열-숫자 변환 함수는 다음과 같은 다양한 단위 유형 정의를 지원합니다.
- V – 전압
- A – 전류
- Ohm – 저항
- Z – 임피던스
- F – 정전 용량
- H – 인덕턴스
- G – 컨덕턴스
- W – 전력
- Hz – 주파수
- Q – 전하
- C – 온도
- dB – 데시벨
- % – 백분율
- m – 길이
- Kg – 질량
- s – 시간
변환기는 표준 배율 인자(마이크로, 킬로, 메가 등)를 지원하므로 mV, uA, kHz, 등의 접두어 약어가 포함된 파라미터 문자열도 처리할 수 있습니다.
다양한 값 표기 형식도 지원합니다. 예를 들어, 동일한 저항값을 다음과 같이 표현할 수 있습니다.
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
요약
지정된 단위 유형을 사용하여 지정된 파라미터 값 문자열을 숫자로 변환하거나 기본 숫자 값을 반환합니다.
구문
StrToNumber(Value : String , Unit : String , Default : Number) : Number
사용 예
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
VoltageRating 파라미터가 반환하는 값 문자열을 전압(V) 단위의 숫자로 변환한 다음, 값이 50V보다 큰 모든 객체를 반환합니다. 파라미터 문자열이나 단위를 인식할 수 없어 변환이 불가능한 경우 기본값 10을 반환합니다.
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
VoltageRating 파라미터가 반환하는 값 문자열을 전압(V) 단위의 숫자로 변환한 다음, 정격값이 10V에서 50V 사이인 모든 객체를 반환합니다. 값을 읽을 수 없는 경우 전압을 6V(정의된 기본값)로 간주합니다.
참고 사항
단위를 인식하는 문자열-숫자 변환 함수는 다음과 같은 다양한 단위 유형 정의를 지원합니다.
- V – 전압
- A – 전류
- Ohm – 저항
- Z – 임피던스
- F – 정전 용량
- H – 인덕턴스
- G – 컨덕턴스
- W – 전력
- Hz – 주파수
- Q – 전하
- C – 온도
- dB – 데시벨
- % – 백분율
- m – 길이
- Kg – 질량
- s – 시간
변환기는 표준 배율 인자(마이크로, 킬로, 메가 등)를 지원하므로 mV, uA, kHz, 등의 접두어 약어가 포함된 파라미터 문자열도 처리할 수 있습니다.
다양한 값 표기 형식도 지원합니다. 예를 들어, 동일한 저항값을 다음과 같이 표현할 수 있습니다.
- 2k2
- 2.2k
- 2200
- 2,200