Função CLng

Converte qualquer cadeia de texto ou expressão numérica num número inteiro longo.

Sintaxe:


CLng (Expressão como variante) como Long

Tipo de retorno:

Long

Parâmetros:

Expressão: Qualquer expressão de cadeia de caracteres ou numérica que pretenda converter. Para converter uma expressão de cadeia de caracteres, o número deve ser introduzido como texto normal, utilizando o formato numérico predefinido das suas LibreOffice configurações regionais. Por exemplo, o número deve ser introduzido utilizando um ponto «.» como separador decimal e uma vírgula «,» como separador de milhares (por exemplo, 123,456.78) para as definições de localização em inglês.

Se Expression estiver fora do intervalo válido de inteiros longos, compreendido entre -2.147.483.648 e 2.147.483.647, o LibreOffice Basic devolve um erro de transbordamento.

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

Códigos de erro

5 Chamada de procedimento inválido

Exemplo:

As expressões numéricas são apresentadas de acordo com as definições regionais 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