Função CLng

Converte uma string ou expressão numérica em um inteiro longo.

Sintaxe:


CLng (Expression As Variant) As Long

Valor de retorno:

Long

Parâmetros:

Expressão: qualquer string ou expressão numérica a converter. Para converter uma expressão de string, o número deve ser inserido como texto normal usando o formato de número padrão das configurações de localidade do LibreOffice. Por exemplo, o número deve ser inserido usando um ponto "." como ponto decimal e uma vírgula "," como separador de milhares (por exemplo 123,456.78) para a configuração de localidade em inglês.

Se Expression estiver fora do intervalo válido de inteiro longo entre -2.147.483.648 e 2.147.483.647, o LibreOffice BASIC retornará um erro de transbordo.

Esta função sempre arredonda a parte fracionária de um número para o número inteiro mais próximo.

Códigos de erro:

5 Chamada de procedimento inválida

Exemplo:

As expressões numéricas são exibidas conforme as configurações de localidade do LibreOffice:


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