Val

Converte string em numero. Str faz o caminho inverso. Usado bastante pra parsear valores vindos de input ou arquivos texto.

Assinatura: Val(cString) -> nNumero

Retorna: Numeric

Conversao basica entre string e numero. Val() de string pra numero, Str() de numero pra string.

Sintaxe

nNum := Val(cString)
cStr := Str(nNum, nTam, nDec)

Exemplo

nValor := Val("1234.56")              // 1234.56
cValor := Str(nValor, 12, 2)          // "     1234.56" (alinhado direita, 12 chars)
cValor := AllTrim(Str(nValor))        // "1234.56" (sem espacos)
cValor := AllTrim(Str(nValor, 14, 2)) // "1234.56" (com casas decimais)

// Val ignora caracter nao-numerico (para na primeira letra):
Val("100abc")     // 100
Val("abc100")     // 0

Pegadinhas

Str() sem args usa 10 chars alinhado a direita. Quase sempre voce quer AllTrim(Str(...))
Val() nao gera erro em string nao-numerica — retorna 0
Decimal: Val so reconhece . (ponto), nao virgula. Pra parsear input pt-BR: Val(StrTran(cInput, ",", "."))

Parâmetros

Nome	Tipo	Obrigatório	Descrição
`cString`	Character	sim	String a converter

Exemplos

Parsear input pt-BR

nValor := Val(StrTran(cInput, ",", "."))

Veja também