Conteúdo
Índice 🔎︎

# Função CInt

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

## Sintaxe:

    CInt (Expression)

## Valor de retorno:

Integer

## Parâmetros:

Expression: qualquer expressão que você queira converter.

Se o argumento é um numero, ele é usado como um valor numérico da expressão.

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 região 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:

    Sub ExampleCountryConvert
        MsgBox CDbl(1234.5678)
        MsgBox CInt(1234.5678)
        MsgBox CLng(1234.5678)
    End Sub