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