CLng Function

Converts any string or numeric expression to a long integer.

Syntax:


CLng (Expression As Variant) As Long

Return value:

Long

Parameters:

Expression: Any string or numeric expression that you want to convert. To convert a string expression, the number must be entered as normal text using the default number format of your LibreOffice locale settings. For instance, the number must be entered using a dot "." as the decimal point and a comma "," as the thousands separator (for instance 123,456.78) for the English locale setting.

If Expression lies outside the valid long integer range between -2.147.483.648 and 2.147.483.647, LibreOffice Basic returns an overflow error.

This function always rounds the fractional part of a number to the nearest integer.

Error codes:

5 Invalid procedure call

Example:

Numeric expressions are displayed according to LibreOffice locale settings:


Sub ExampleCountryConvert
    MsgBox CDbl(1234.5678) ' 1234.5678
    MsgBox CInt(1234.5678) ' 1235
    MsgBox CLng(1234+5678) ' 6912
    MsgBox CSng(1234.5678) ' 1234.567749023

    MsgBox CDbl(expression := 5678.1234) ' 5678.1234
    MsgBox CInt(expression := 5678.1234) ' 5678
    MsgBox CLng(expression := 5678+1234) ' 6912
    MsgBox CSng(expression := 5678.1234) ' 5678.123535156
End Sub