Sumário

# Função CInt

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

### Sintaxe:

    CInt (Expression As Variant) As Integer

### Tipo de retorno:

Integer

### 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 o argumento for string, a função corta o espaço em branco à esquerda; em seguida, ela tenta reconhecer números nos caracteres seguintes. As sintaxes abaixo são reconhecidas:

- Números decimais (com sinal opcional na frente) usando separadores decimais e separadores de grupo configurados para a localidade no LibreOffice (separadores de grupo são aceitos em qualquer posição), com notação exponencial opcional da forma "-12e+1" (onde um número decimal inteiro com sinal opcional após e ou E ou d ou D, define a potência de 10);

- Números octais como "&Onnn...", onde "nnn..." depois de "&O" ou "&o" é uma sequência de até 11 dígitos, de 0 a 7, até o próximo caractere não alfanumérico;

- Números hexadecimais como "&Hnnn...", onde "nnn..." depois de "&H" ou "&h" é a sequência de caracteres até o próximo caractere não alfanumérico e não deve ter mais de 8 dígitos, de 0 a 9, A a F ou a a f.

O resto da string é ignorado. Se a string não for reconhecida, por exemplo, quando depois de cortar o espaço em branco inicial, ela não começar com sinal de mais, menos, um dígito decimal ou "&", ou quando a sequência após "&O" tiver mais de 11 caracteres ou contiver um caractere alfabético, o valor numérico da expressão é 0 .

Se um argumento é um erro, o número do erro é usado como um valor numérico da expressão.

Se o argumento for uma data, o número de dias desde 1899-12-30 (data serial) é usado como um valor numérico da expressão. A hora é representada como fração de um dia.

Após calcular o valor numérico da expressão, esse é arredondado para o número inteiro mais próximo (se necessário) e se o resultado não for entre -32768 e 32767, o LibreOffice Basic reporta um erro de overflow. Caso contrário, retorna o resultado.

### 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

Tópicos relacionados

Função CBool

Função CByte

Função CCur

Função CDate

Função CDbl

Função CDec

Função CLng

Função CSng

Função CStr