Função Val

Devolve os números contidos numa cadeia como um valor numérico do tipo adequado.

Sintaxe

Val(cadeia)

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

Comentários

A função Val deixa de ler a cadeia no primeiro caráter que não consegue reconhecer como parte de um número. Os símbolos e carateres que são frequentemente 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 radix (para octal) e &H (para hexadecimal). Os espaços em branco, os separadores e os carateres de linefeed são removidos do argumento .

O seguinte devolve o valor 1615198:

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

No código seguinte, Val devolve o valor decimal -1 para o valor hexadecimal mostrado:

Val("&HFFFF")

Observação

A função Val reconhece apenas o ponto final ( . ) como um separador decimal válido. Quando são utilizados diferentes separadores decimais, como em aplicações internacionais, utilize o CDbl para converter uma cadeia num número.

Exemplo

Este exemplo utiliza a função Val para devolver os números contidos numa cadeia.

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 num erro de correspondência de tipo. Por exemplo, 50% representado como a cadeia "50%" será convertido conforme esperado para 50, mas Val("50,5%") gerará um erro porque o símbolo de percentagem é visto como um sufixo para declarar o Tipo de Dados como um Número Inteiro, o que não é neste caso. A lista completa de sufixos de tipo de dados é composta por Single ( ! ), Conversor de Moedas ( @ ), Double ( # ), String ( $ ), Integer ( % ), Long ( & ) e LongLong ( ^ ) para anfitriões de 64 bits.

Confira também

• Funções (Visual Basic for Applications)

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.