Units 構造体 - システム単位および表示単位へのアクセス

Units 構造体は、システム単位のスケール、タイプ、および表示単位を取得および設定するためのシステムグローバル変数および特定のメソッドへのアクセスを提供します。

システムグローバル:

units.DisplayType

現在の単位表示タイプを <name> で取得/設定します。

有効な単位表示タイプは次のとおりです。

#Generic #Metric #US #custom

units.MetricType

現在のメートル単位の表示タイプを <name> で取得/設定します。

有効なメートル単位の表示タイプは次のとおりです。

#Millimeters #Centimeters #Meters #Kilometers

units.USType

現在の US 標準単位の表示タイプを <name> で取得/設定します。

有効な US 標準単位の表示タイプは次のとおりです。

#Frac_In #Dec_In #Frac_Ft #Dec_Ft #Ft_Frac_In #Ft_Dec_In

units.USFrac

現在の US 分数の表示タイプを <name> で取得/設定します。

有効な US 分数の表示タイプは次のとおりです。

#Frac_1_1 #Frac_1_2 #Frac_1_4 #Frac_1_8 #Frac_1_10 #Frac_1_16 #Frac_1_32 #Frac_1_64 #Frac_1_100

units.CustomName

現在のカスタム単位名を <string> で取得/設定します。

units.CustomValue

現在のカスタム単位値を <float> で取得/設定します。

units.CustomUnit

現在のカスタム単位タイプを <name> で取得/設定します。

有効なカスタム単位の表示タイプは次のとおりです。

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers

units.SystemScale

現在のシステム単位スケールの値を <float> で取得/設定します。

これは、[カスタマイズ](Customize Units Setup) > [システム単位設定](System Units Setup) > [システム単位スケール](System Units Scale)領域に表示される値です。

units.SystemType

現在のシステム単位スケールのタイプを <name> で取得/設定します。

これは、[カスタマイズ](Customize) > [単位設定](Units Setup) > [システム単位設定](System Units Setup) > [システム単位スケール](System Units Scale)領域に表示される単位です。

有効なシステム単位のタイプは次のとおりです。

#Inches #Feet #Miles #Millimeters #Centimeters #Meters #Kilometers

メソッド:

units.formatValue <float>

現在の単位スケールの <float> を表す <string> 値を返します。

このメソッドでは、文字列オーバーフローが発生する可能性があります(特に単位がマイルまたはキロメートルに設定されている場合)。

オーバーフローが発生すると、ランタイムエラーが生成されます。

例:

units.DisplayType = #Generic
-->#Generic
units.SystemType = #inches
-->#inches
units.formatValue 123.45
-->"123.45"
units.DisplayType = #Metric
-->#metric
units.MetricType = #meters
-->#meters
units.formatValue 123.45
-->"3.136m"
units.MetricType = #centimeters
-->#centimeters
units.formatValue 123.45
-->"313.563cm"
units.DisplayType = #US
-->#us
units.USType = #ft_Frac_In
-->#ft_Frac_In
units.formatValue 123.45
-->"10'3 14/32""
units.USType = #Dec_Ft
-->#dec_Ft
units.formatValue 123.45
-->"10.287'"
units.DisplayType = #Custom
--#custom
units.formatValue 123.45
-->"0.016FL"

units.decodeValue <string>

現在の単位設定を使用して <string> を解析し、<float> を返します。

文字列の解析中にエラーが発生すると、ランタイムエラーが生成されます。

これは、上記で説明した units.formatValue() の逆関数です。

値の後方および前方変換は、概数エラーによる精度低下を招きます。

例:

units.DisplayType = #Generic
-->#Generic
units.decodeValue "3.136m"
-->123.465
units.decodeValue "313.563cm"
-->123.45
units.decodeValue "10'3 14/32\""
-->123.438
units.decodeValue "10.287'"
-->123.444
units.decodeValue "0.016FL"
-->126.72