サブタイプByteのバリアントに変換された式を戻します。
構文
CByte(expression)
備考
expression引数は任意の有効な式です。
CByte関数を使用して、他のデータ型からByteサブタイプへの国際的に認識される変換を提供します。たとえば、システムのロケール設定に応じて、異なる3桁ごとの区切り文字と同様に、異なる小数点が適切に認識されます。
式がbyteサブタイプの許容範囲外にある場合、エラーが発生します。次の例では、CByte関数を使用して式をバイトに変換します:
次の例では、CByte関数の使用方法を示します:
例1:
Dim MyDouble, MyByte MyDouble = 125.5678 ' MyDouble is a Double. MyByte = CByte(MyDouble) 'Output: 126
例2:
Dim MyInt MyInt = 100 ' MyInt is an Integer. MyByte = CByte(MyInt) 'Output: 100
例3:
Dim MyString MyString = "50" ' MyString is a String. MyByte = CByte(MyString) 'Output: 50
例4:
Dim MyDouble, MyByte MyDouble = 125.4 ' MyDouble is a Double. MyByte = CByte(MyDouble) 'Output: 125
例5:
Dim MyDouble, MyByte MyDouble = 125.5 ' MyDouble is a Double. MyByte = CByte(MyDouble) ' 125.5 round to 126 (nearest even number) 'Output: 126
例6:
Dim MyDouble, MyByte MyDouble = 124.5 ' MyDouble is a Double. MyByte = CByte(MyDouble) ' 124.5 round to 124 (nearest even number) 'Output: 124
注:
CByteは、数値の小数部を丸めるのではなく切り捨てるFix関数およびInt関数とは異なります。小数部が0.5の場合、CByte関数は常に最も近い偶数に丸めます。たとえば、0.5は0に、1.5は2に丸めます。