Histórico da Página

Sintaxe

VAL( <expressão caracter> )

Propósito

Converte um número contido em uma expressão numérica para um valor numérico.

Argumentos

< expressão caracter >

Define a expressão caracter que será convertida. Ela deve ser formada apenas por dígitos numéricos.

Utilização

A função VAL() é útil quando se necessita realizar cálculos com expressões caracter que contenham números.

Se a expressão que será convertida consistir de outros caracteres que não sejam numéricos ou de brancos à esquerda dos números, o valor numérico resultante será zero.

A função VAL() finaliza a sua conversão quando um segundo ponto decimal  ou o primeiro caracter não numérico for encontrado antes do final da cadeia de caracteres especificada.

Dicas

A função VAL() é o inverso das funções STR(), TRANSFORM() e STRZERO(), que convertem valores numéricos para cadeias de caracteres.

Exemplos

VAL("12.1234")         // Resulta: 12.12

VAL("12.1256")         // Resulta: 12.13

VAL("12A12")           // Resulta: 12.00

VAL("A1212")           // Resulta: 0.00

VAL(SPACE(0))       // Resulta: 0.00

VAL(SPACE(1))       // Resulta: 0.00

VAL(" 12.12")           // Resulta: 12.12

VAL("12 .12")           // Resulta: 12.00

cValor := “123”         // “123” é uma cadeia de caracteres

nValor := 100           // 100 é um valor numérico

// Resulta em erro (“Data type mismatch”)

MsgAlert(cValor + nValor)

// Resulta 223

MsgAlert( VAL(cValor) + nValor )

// Resulta o valor numérico 123

MsgAlert( VAL(cValor) )

// Resulta zero (0)

MsgAlert( VAL(“XYZ”) )