CByte function (LotusScript® Language)

Returns an expression converted to the Byte data type.

Note: This function is new with Domino® Release 6.


CByte ( expr )



Any numeric expression, or a string expression that LotusScript® can convert to a number.

Return value

CByte returns an expression that has been converted to Byte.

CByte(EMPTY) returns 0.

If expr is a string expression, CByte returns the numeric representation of the string, rounded to the nearest integer. If LotusScript® cannot convert the string to a number, the function raises an error.

If expr lies outside the acceptable range for the Byte data type, the function raises an error.