VAL()
 Converte um número presente em uma cadeia de caracteres para um valor
 numérico
------------------------------------------------------------------------------

 Sintaxe

     VAL(<cNúmero>) --> nNúmero

 Argumentos

     <cNúmero> é a expressao caractere a ser convertida.

 Retorno

     VAL() retorna <cNúmero> convertido para um valor numérico, incluindo
     dígitos decimais.

 Descriçao

     VAL() é uma funçao de conversao de caracteres, a qual converte uma
     cadeia de caracteres que contém dígitos numéricos para um valor
     numérico.  Quando VAL() é executada, ela avalia <cNúmero> até encontrar
     o segundo ponto decimal, o primeiro caractere nao numérico, ou o final
     da expressao.  Os espaços à direita sao ignorados.  Com SET FIXED em
     ON, VAL() retorna a quantidade de casas decimais especificadas por SET
     DECIMALS, arredondando <cNúmero> se ele for especificado com uma
     quantidade de dígitos maior do que o valor corrente de DECIMALS.  Da
     mesma forma que todas as outras funçoes que arredondam, os dígitos
     entre zero e quatro sao arredondados para baixo, e os dígitos entre
     cinco e nove sao arredondados para cima.  Com SET FIXED em OFF, VAL()
     retorna a quantidade de casas decimais especificadas em <cNúmero>.

     VAL() é o oposto de STR() e TRANSFORM(), as quais convertem valores
     numéricos para cadeias de caracteres.

 Exemplos

     Os exemplos a seguir ilustram VAL() com SET FIXED ON, e SET DECIMALS
     TO 2:

     SET DECIMALS TO 2
     SET FIXED ON
     //
     ? 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

 Arquivos:  Biblioteca CLIPPER.LIB.
 To download this example - click here.

See Also: ROUND() STR() TRANSFORM() SET DECIMALS SET FIXED