ROUND()
 Retorna um valor numérico arredondado para uma quantidade especificada de
 dígitos
------------------------------------------------------------------------------

 Sintaxe

     ROUND(<nNúmero>, <nDecimais>) --> nArredondado

 Argumentos

     <nNúmero> é o valor numérico a ser arredondado.

     <nDecimais> define a quantidade de casas decimais a serem retidas.
     Especificando-se um valor <nDecimais> negativo arredonda números
     inteiros.

 Retorno

     ROUND() retorna um valor numérico.

 Descriçao

     ROUND() é uma funçao numérica que arredonda <nNúmero> para a quantidade
     de casas especificada por <nDecimais>.  Especificando-se um valor zero
     ou negativo para <nDecimais> permite o arredondamento de números
     inteiros.  Um <nDecimais> negativo indica a quantidade de casas à
     esquerda do ponto decimal a serem arredondadas.  Dígitos entre cinco e
     nove, inclusive, sao arredondados para cima.  Dígitos abaixo de cinco
     sao arredondados para baixo.

     A exibiçao do valor de retorno nao obedece à cofiguraçao de DECIMALS, a
     nao ser que SET FIXED esteja ON.  Com SET FIXED OFF, a exibiçao do
     valor de retorno contém a mesma quantidade de casas decimais que você
     especificar para <nDecimais>, ou zero se <nDecimais> for menor do que
     um.

 Exemplos

       Os exemplos a seguir arredondam valores com dígitos decimais:

        SET DECIMALS TO 2
        SET FIXED ON
        //
        ? ROUND(10.4, 0)                      // Resulta: 10.00
        ? ROUND(10.5, 0)                      // Resulta: 11.00
        ? ROUND(10.51, 0)                     // Resulta: 11.00
        ? ROUND(10.49999999999999, 2)         // Resulta: 10.50

       Estes exemplos utilizam um argumento <nDecimais> negativo
        para arredondar valores numéricos para valores numéricos inteiros:

        ? ROUND(101.99, -1)                   // Resulta: 100.00
        ? ROUND(109.99, -1)                   // Resulta: 110.00
        ? ROUND(109.99, -2)                   // Resulta: 100.00

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

See Also: INT() STR() VAL() SET DECIMALS SET FIXED