Query_Lang-PCBFunctions_Parameters_StrToNumberDefStrToNumberDef_AD

現在、バージョン 19. をご覧頂いています。最新情報については、バージョン Query_Lang-PCBFunctions_Parameters_StrToNumberDef((StrToNumberDef))_AD の 21 をご覧ください。

Parent page: PCB Query Functions - Parameters

Summary

Converts the nominated Parameter Value string to a number, or a default number, using the stipulated unit type.

Syntax

StrToNumber(Value : String , Unit : String , Default : Number) : Number

Example Usage

StrToNumberDef(ParameterValue('VoltageRating'),V,10)  >  50
Converts the Value string returned by the VoltageRating Parameter to a number, using Voltage (V) as the unit, then returns all objects with a Value greater than 50V. If the Parameter string or unit is unrecognized (can't be converted), a default value of 10 is returned.

StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
Converts the Value string returned by the VoltageRating Parameter to a number, using Voltage (V) as the unit, then returns all objects with a Value rating between 10V and 50V. If the value cannot be read, a voltage of 6V (the defined default value) is assumed.

TIPS

The unit-aware string-to-number converter function accepts a large range of Unit type definitions, including:

  • V – Voltage
  • A – Current
  • Ohm – Resistance
  • Z – Impedance
  • F – Capacitance
  • H – Inductance
  • G – Conductance
  • W – Power
  • Hz – Frequency
  • Q – Charge
  • C – Temperature
  • dB – Decibels
  • % – Percent
  • m – Length
  • Kg – Mass
  • s – Time

The converter accepts standard value scaling factors (micro, kilo, mega etc) and therefore Parameter strings containing prefix abbreviations such as mV, uA, kHz etc.

Several value constructs are also supported. For example, the same resistance value can be represented as:

  • 2k2
  • 2.2k
  • 2200
  • 2,200
If you find an issue, select the text/image and pressCtrl + Enterto send us your feedback.
注記

利用できる機能は、Altium 製品のアクセスレベルによって異なります。Altium Designer ソフトウェア サブスクリプション の様々なレベルに含まれる機能と、Altium 365 プラットフォーム で提供されるアプリケーションを通じて提供される機能を比較してください。

ソフトウェアの機能が見つからない場合は、Altium の営業担当者に連絡して 詳細を確認してください。