Função Val

  • Artigo

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

Sintaxe

Val(string)

O argumento de 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 pode reconhecer como parte de um número. Símbolos e caracteres que geralmente são considerados partes de valores numéricos, como sinais de dólar e vírgulas, não são reconhecidos.

No entanto, a função reconhece os prefixos &O radix (para octal) e &H (para hexadecimal). Os caracteres blanks, tabs e linefeed são retirados 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 período ( . ) como um separador decimal válido. Quando separadores decimal diferentes são usados, como em aplicativos internacionais, use o CDbl em vez de 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, 50% representados como a cadeia de caracteres "50%" serão convertidas conforme o esperado para 50, mas Val("50,5%") gerará um erro porque o símbolo percentual é 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 inclui 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.