CByte関数

サブタイプ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に丸めます。