[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 ROUND()
 Return a numeric value rounded to a specified number of digits
------------------------------------------------------------------------------
 Syntax

     ROUND(<nNumber>, <nDecimals>) --> nRounded

 Arguments

     <nNumber> is the numeric value to be rounded.

     <nDecimals> defines the number of decimal places to retain.
     Specifying a negative <nDecimals> value rounds whole number digits.

 Returns

     ROUND() returns a numeric value.

 Description

     ROUND() is a numeric function that rounds <nNumber> to the number of
     places specified by <nDecimals>.  Specifying a zero or negative value
     for <nDecimals> allows rounding of whole numbers.  A negative
     <nDecimals> indicates the number of digits to the left of the decimal
     point to round.  Digits between five to nine (inclusive) are rounded up.
     Digits below five are rounded down.

     The display of the return value does not obey the DECIMALS setting
     unless SET FIXED is ON.  With SET FIXED OFF, the display of the return
     value contains as many decimal digits as you specify for <nDecimals>, or
     zero, if <nDecimals> is less than one.

 Examples

     .  These examples round values with decimal digits:

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

     .  These examples use a negative <nDecimals> argument to round
        numeric values to whole number values:

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

 Files   Library is CLIPPER.LIB.


See Also: SET DECIMALS SET FIXED STR() VAL()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson