Ir diretamente para o conteúdo principal

CLng

Devolve uma expressão que foi convertida num Variant do subtipo Long.

Estrutura

CLng(expressão)

Parâmetros

O argumento «expressão» pode ser qualquer expressão válida.

Descrição

Em geral, pode documentar o seu código utilizando as funções de conversão de subtipos para indicar que o resultado de uma determinada operação deve ser expresso como um tipo de dados específico, em vez do tipo de dados predefinido. Por exemplo, utilize Cint ou CLng para forçar a aritmética de inteiros nos casos em que normalmente se aplicaria a aritmética de moeda, de precisão simples ou de precisão dupla.

Utilize a função CLng para efetuar conversões compatíveis com os padrões internacionais de qualquer outro tipo de dados para um subtipo Long. Por exemplo, os diferentes separadores decimais são reconhecidos corretamente consoante a configuração regional do seu sistema, tal como acontece com os diferentes separadores de milhares.

Se a expressão estiver fora do intervalo aceitável para o subtipo Long, ocorre um erro.

Exemplo

O exemplo seguinte utiliza a função CLng para converter um valor num Long:

Dim MyVal1, MyVal2, MyLong1, MyLong2

; MyVal1 = 25427,45; MyVal2 = 25427,55; ' MyVal1 e MyVal2 são do tipo Double.

MyLong1 = CLng(MyVal1) ' MyLong1 contém 25427.

MyLong2 = CLng(MyVal2) ' MyLong2 contém 25428.

Nota

A função CLng difere das funções Fix e Int, que truncam, em vez de arredondarem, a parte fracionária de um número. Quando a parte fracionária é exatamente 0,5, a função CLng arredonda-a sempre para o número par mais próximo. Por exemplo, 0,5 redonda equivale a 0 e 1,5 redonda equivale a 2. |