CBytefunction

Converts numeric or string expression to Byte.

Syntax

Declare Function CByte ( ByVal expression As datatype ) As Byte

Type typename

Declare Operator Cast ( ) As Byte

End Type

Parameters

Name		Description
`expression`		A numeric, string, or pointer expression to cast to a `Byte` value.
`datatype`		Any numeric, string, or pointer data type.
`typename`		A user defined type.

Return value

A Byte 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.

Remarks

Usage



result = CByte( numeric expression )

result = CByte( string expression )

result = CByte( user defined type )

Dialect Differences

Not available in the -lang qb dialect unless referenced with the alias __Cbyte.

Differences from QB

New to FreeBASIC

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

Reference

Documented in KeyPgCbyte.html