CLng関数

サブタイプLongのバリアントに変換された式を戻します。

構文

CLng(expression)

備考

expression引数は任意の有効な式です。

CLng関数を使用して、他のデータ型からLongサブタイプへの国際的に認識される変換を提供します。たとえば、システムのロケール設定に応じて、異なる3桁ごとの区切り文字と同様に、異なる小数点が適切に認識されます。

式がLongサブタイプの許容範囲外にある場合、エラーが発生します。

次の例では、CLng関数を使用して、値をLongに変換します:

例1:

Dim MyVal1, MyVal2, MyLong1, MyLong2
MyVal1 = 25427.45: MyVal2 = 25427.55   ' MyVal1, MyVal2 are Doubles.
MyLong1 = CLng(MyVal1)   
'Output: 25427
MyLong2 = CLng(MyVal2)   
'Output: 25428

例2:

Dim MyString, MyLong
MyString = "123456.78"    
MyLong = CLng(MyString)   
'Output: 123457

例3:

Dim MyLocaleString
MyLocaleString = "12.345,67"   ' Locale-specific decimal separator.
MyLong = CLng(MyLocaleString)  ' Convert to Long, interpreted based on locale.
'MyLong contains the correctly interpreted long value within locale settings

例4:

MyDouble = 2.6
MyLong = CLng(MyDouble)   ' 2.6 rounds to 3.
'Output: 3

例5:

MyDouble = 2.4
MyLong = CLng(MyDouble)   ' 2.4 rounds to 2.
'Output: 2

例6:

MyDouble = 1.5
MyLong = CLng(MyDouble)   ' 1.5 rounds to 2 (nearest even number).
'Output: 2

例7:

MyDouble = 0.5
MyLong = CLng(MyDouble)   ' 0.5 rounds to 0 (nearest even number).
'Output: 0

注:

CLngは、数値の小数部を丸めるのではなく切り捨てるFix関数およびInt関数とは異なります。小数部が0.5の場合、CLng関数は常に最も近い偶数に丸めます。たとえば、0.5は0に、1.5は2に丸めます。