매개변수

Parameters PCB 쿼리 함수는 Query Helper대화상자에 표시됩니다.
이 참조 페이지에서는 PCB 및 PCB 라이브러리 문서에서 사용할 수 있는 Parameters 카테고리의 쿼리 언어 키워드를 자세히 설명합니다. 특정 쿼리 키워드에 대한 도움말은 다음의 접을 수 있는 섹션을 사용하거나, Query Helper 또는 Filter 패널에서 해당 키워드를 강조 표시(또는 내부를 클릭)한 다음 F1를 눌러 해당 섹션으로 즉시 이동하십시오.
CompParameterValue
요약
PCB 컴포넌트 파라미터의 문자열 값을 반환하며, 이를 테스트하여 쿼리를 만족하는 PCB 컴포넌트를 반환할 수 있습니다.
구문
CompParameterValue(ParameterName : String) : String
사용 예
CompParameterValue('Mounting Technology') Like 'SM*'
Mounting Technology 파라미터를 포함하고 그 값 문자열이 SM로 시작하는 모든 컴포넌트를 반환합니다(예: SMT, SMD 등). 또한 트랙, 아크, 패드, 텍스트 등 쿼리를 만족하는 컴포넌트 객체의 연관된 하위 객체도 함께 반환됩니다.
CompParameterValue('Mounting Technology') Like '*SM*'
Mounting Technology 파라미터의 값 문자열에 *SM*가 포함된 모든 컴포넌트와 그에 연관된 하위 객체를 반환합니다.
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
VoltageRating 파라미터 값이 50V보다 큰 모든 컴포넌트와 그에 연관된 하위 객체를 반환합니다. CompParameterValue가 반환하는 문자열 값은 단위 인식 StrToNumber 함수에 의해 비교를 위한 숫자로 변환됩니다.
FootprintParameterValue
요약
PCB 풋프린트(Footprint) 파라미터의 문자열 값을 반환하며, 이를 테스트하여 쿼리를 만족하는 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 파라미터 이름을 가진 모든 컴포넌트 상위 객체를 반환합니다. 또한 트랙, 아크, 패드, 텍스트 등 쿼리를 만족하는 컴포넌트 객체의 연관된 하위 객체도 함께 반환됩니다.
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
Mounting Technology 파라미터를 가진 컴포넌트 상위 객체에 대해, 모든 컴포넌트와 그에 연관된 하위 객체를 except 반환합니다.
HasCompParameterValue
요약
지정된 파라미터 이름을 포함하고, 그 값이 쿼리를 만족하는 PCB 컴포넌트를 반환합니다.
구문
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
사용 예
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
Mounting Technology 파라미터 이름을 가지며 값 속성이 SMT와 일치하는 모든 컴포넌트 상위 객체를 반환합니다. 또한 트랙, 아크, 패드, 텍스트 등 쿼리를 만족하는 컴포넌트 객체의 연관된 하위 객체도 함께 반환됩니다.
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
값이 RoHS-Compliant인 Design Item Status 파라미터가 없는 모든 컴포넌트와 그에 연관된 하위 객체를 반환합니다.
HasFootprintParameter
요약
지정된 풋프린트(Footprint) 파라미터 이름을 포함하는 PCB 컴포넌트를 반환합니다.
구문
HasFootprintParameter(ParameterName : String) : Boolean
사용 예
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
IPC Density 풋프린트 파라미터 이름을 가진 모든 컴포넌트 상위 객체를 반환합니다. 또한 트랙, 아크, 패드, 텍스트 등 쿼리를 만족하는 컴포넌트 객체의 연관된 하위 객체도 함께 반환됩니다.
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
IPC Density 풋프린트 파라미터를 가진 컴포넌트 상위 객체에 대해, 모든 컴포넌트와 그에 연관된 하위 객체를 except 반환합니다.
HasFootprintParameterValue
요약
지정된 풋프린트(Footprint) 파라미터 이름을 포함하고, 그 값이 쿼리를 만족하는 PCB 컴포넌트를 반환합니다.
구문
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
사용 예
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
Mounting Method 풋프린트 파라미터 이름을 가지며 값 속성이 Press Fit. 와 일치하는 모든 컴포넌트 상위 객체를 반환합니다. 또한 트랙, 아크, 패드, 텍스트 등 쿼리를 만족하는 컴포넌트 객체의 연관된 하위 객체도 함께 반환됩니다.
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
값이 Press Fit.
Mounting Method 풋프린트 파라미터가 없는 모든 컴포넌트와 그에 연관된 하위 객체를 반환합니다.
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*'
Mounting Technology 파라미터를 가지며 값 문자열이 SM로 시작하는 모든 객체를 반환합니다(예: SMT, SMD 등).
ParameterValue('Mounting Technology') Like '*SM*'
Mounting Technology 파라미터를 가지며 값 문자열에 SM가 포함된 모든 객체를 반환합니다.
StrToNumber(ParameterValue('VoltageRating'),V) > 50
VoltageRating 파라미터 값이 50V보다 큰 모든 객체를 반환합니다. ParameterValue가 반환하는 문자열 값은 단위 인식 StrToNumber 함수에 의해 비교를 위한 숫자로 변환됩니다.
StrToNumber
요약
지정된 단위 유형을 사용하여 지정된 파라미터 값 문자열을 숫자로 변환합니다.
구문
StrToNumber(Value : String , Unit : String) : Number
사용 예
StrToNumber(ParameterValue('VoltageRating'),V) > 50
VoltageRating 파라미터가 반환한 값 문자열을 전압(V)을 단위로 사용해 숫자로 변환한 다음, 값이 50V보다 큰 모든 객체를 반환합니다.
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
Resistance 파라미터가 반환한 값 문자열을 저항(ohms)을 단위로 사용해 숫자로 변환한 다음, 값이 1kΩ~10kΩ 사이인 모든 객체를 반환합니다.
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
CapacitanceValue 파라미터가 반환한 값 문자열을 커패시턴스(F)를 단위로 사용해 숫자로 변환한 다음, 값이 2nF 미만인 모든 객체를 반환합니다(2e-9는 과학적 표기법).
참고
값 문자열을 숫자로 변환할 수 없으면 스크립팅 오류가 발생합니다. 이 상황을 처리하려면 변환이 실패할 경우 지정된 기본 숫자를 반환하는 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