CInt Function

Converts any string or numeric expression to an integer.

Syntax:


CInt (Expression)

Return value:

Integer

Parameters:

Expression: Any expression that you want to convert.

If the argument is a number, it is used as numeric value of the expression.

If the argument is string, the function trims the leading white space; then it tries to recognise a number in following characters. The syntax below are recognised:

The rest of the string is ignored. If the string is not recognised, e.g. when after trimming leading whitespace it doesn't start with plus, minus, a decimal digit, or "&", or when the sequence after "&O" is longer than 11 characters or contains an alphabetic character, the numeric value of expression is 0.

If the argument is an error, the error number is used as numeric value of the expression.

If the argument is a date, number of days since 1899-12-30 (serial date) is used as numeric value of the expression. Time is represented as fraction of a day.

After calculating the numeric value of the expression, it is rounded to the nearest integer (if needed), and if the result is not between -32768 and 32767, LibreOffice Basic reports an overflow error. Otherwise, the result is returned.

Error codes:

5 Invalid procedure call

Example:


Sub ExampleCountryConvert
    MsgBox CDbl(1234.5678)
    MsgBox CInt(1234.5678)
    MsgBox CLng(1234.5678)
End Sub

Please support us!