CByte
Converts numeric or string expression to Byte.
result = CByte( numeric expression )
result = CByte( string expression )
result = CByte( user defined type )
expression
The CByte function rounds off the decimal part and returns a 8-bit Byte value. The function does not check for an overflow, and results are undefined for values which are less than -128 or larger than 127.
The name can be explained as 'Convert to Byte'.
If the argument is a string expression, it is converted to numeric by using ValInt.
Syntax
Usage
result = CByte( numeric expression )
result = CByte( string expression )
result = CByte( user defined type )
Parameters
expression
A numeric, string, or pointer expression to cast to a Byte value.
datatypeAny numeric, string, or pointer data type.
typenameA user defined type.
Return Value
Description
The CByte function rounds off the decimal part and returns a 8-bit Byte value. The function does not check for an overflow, and results are undefined for values which are less than -128 or larger than 127.
The name can be explained as 'Convert to Byte'.
If the argument is a string expression, it is converted to numeric by using ValInt.
Example
' Using the CBYTE function to convert a numeric value
'Create an BYTE variable
Dim numeric_value As Byte
'Convert a numeric value
numeric_value = CByte(-66.30)
'Print the result, should return -66
Print numeric_value
Sleep
'Create an BYTE variable
Dim numeric_value As Byte
'Convert a numeric value
numeric_value = CByte(-66.30)
'Print the result, should return -66
Print numeric_value
Sleep
Dialect Differences
- Not available in the -lang qb dialect unless referenced with the alias __Cbyte.
Differences from QB
- New to FreeBASIC
See also