Função Val

Retorna os números contidos em uma cadeia de caracteres como um valor numérico do tipo apropriado.

Sintaxe

val(string)

O argumentode cadeia de caracteres necessário é qualquer expressão de cadeia de caracteres válida.

Comentários

A função Val para de ler a cadeia de caracteres no primeiro caractere que não consegue reconhecer como parte de um número. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como cifrões e vírgulas, não são reconhecidos.

No entanto, a função reconhece os prefixos &O da base (para octal) e &H (para hexadecimal). Os caracteres em branco, as guias e os caracteres de alimentação de linha são removidos do argumento.

O seguinte retorna o valor 1615198:

Val("    1615 198th Street N.E.")

No código a seguir, Val retorna o valor decimal -1 para o valor hexadecimal mostrado:

Val("&HFFFF")

Observação

A função Val reconhece apenas o ponto ( . ) como um separador decimal válido. Quando separadores decimais diferentes são usados, como em aplicativos internacionais, use CDbl em vez disso para converter uma cadeia de caracteres em um número.

Exemplo

Este exemplo usa a função Val para retornar os números contidos em uma cadeia de caracteres.

Dim MyValue
MyValue = Val("2457")    ' Returns 2457.
MyValue = Val(" 2 45 7")    ' Returns 2457.
MyValue = Val("24 and 57")    ' Returns 24.

Observação

A função Val reconhece sufixos de tipo de dados preteridos antes da conversão e pode resultar em um erro de incompatibilidade de tipo. Por exemplo, cinquenta por cento representado como a cadeia de caracteres "50%" será convertido como esperado para 50, mas Val("50,5%") gerará um erro porque o símbolo de porcentagem é visto como um sufixo para declarar o Tipo de Dados como um Inteiro, o que não é neste caso. A lista completa de sufixos de tipo de dados compreende Single ( !), Conversor de Moedas ( @ ), Double ( # ), String ( $ ), Integer ( % ), Long ( & ) e LongLong ( ^ ) para hosts de 64 bits.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.

  • Last updated on