Function Round() Foundation
Rounds a numeric value to a specific number of decimal places.
Syntax
Round( <nValue>, <nDecimals>) --> nRoundedValue
Parameters
<nValue>
<nValue> is a numeric expression whose value is rounded.
<nDecimals>
<nDecimals> generally specifies the number of places after the decimal point in the rounded result. However, when <nDecimals> is negative, it specifies the number of places before the decimal point that are rounded.
Return
Round() returns a numeric value.
Description
When <nDecimals> is greater than or equal to zero, the numeric function Round() rounds the value <nValue> to the number of decimal places specified by <nDecimals>. When <nDecimals> is a negative value, the places before the decimal point are rounded. The digits 5 to 9 are rounded up, while the digits 0 to 4 round down.
Examples
// The example shows various results of the function Round().
PROCEDURE Main
SET DECIMALS TO 4
SET FIXED ON
? Round( 121.4487, 0) // result: 121.0000
? Round( 121.4487, 1) // result: 121.4000
? Round( 121.4487, 2) // result: 121.4500
? Round( 121.4487, 3) // result: 121.4490
? Round( 121.4487,-1) // result: 120.0000
? Round( 121.4487,-2) // result: 100.0000
? Round( 121.4487,-3) // result: 0.0000
SET FIXED OFF
? Round( 121.4487, 0) // result: 121
? Round( 121.4487, 1) // result: 121.4
? Round( 121.4487, 2) // result: 121.45
? Round( 121.4487, 3) // result: 121.449
? Round( 121.4487,-1) // result: 120
? Round( 121.4487,-2) // result: 100
? Round( 121.4487,-3) // result: 0
RETURN
Feedback
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.