CBYTE

The CBYTE() function converts its argument to an unsigned 8-bit byte value.

Function header

DECLARE FUNCTION CBYTE AS BYTE (arg AS INT) SHARED STATIC INLINE
DECLARE FUNCTION CBYTE AS BYTE (arg AS WORD) OVERLOAD SHARED STATIC INLINE
DECLARE FUNCTION CBYTE AS BYTE (arg AS LONG) OVERLOAD SHARED STATIC INLINE
DECLARE FUNCTION CBYTE AS BYTE (arg AS FLOAT) OVERLOAD SHARED STATIC INLINE

If the argument is an INT, WORD or LONG then the function will truncate the number to 8 bits, keeping the least significant byte and discarding the rest. If the argument is a FLOAT then it will be rounded, converted to fixed point, and then truncated to 8 bits.

Examples

PRINT CBYTE(-1) : REM integer to byte, outputs 255
PRINT CBYTE(65535) : REM word to byte, outputs 255
PRINT CBYTE(100.4) : REM float to byte, outputs 100