[#BloombergLP-bdldfp-DecimalImpUtil-round-07]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalImpUtil.adoc[DecimalImpUtil]::round
:relfileprefix: ../../../
:mrdocs:

Return `x` rounded to the specified `precision`.

== Synopsis

Declared in `<bdldfp_decimalimputil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdldfp/DecimalImpUtil/ValueType32.adoc[ValueType32]
round(
    xref:BloombergLP/bdldfp/DecimalImpUtil/ValueType32.adoc[ValueType32] x,
    unsigned int precision);
----

== Description

Round halfway cases away from zero, regardless of the current decimal floating point rounding mode. If `x` is integral, positive zero, negative zero, NaN, or infinity then return `x` itself.

Examples: `round(3.14159, 3)` ==> 3.142

== Return Value

`x` rounded to the specified `precision`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *x*
| value to round
| *precision*
| number of digits after the decimal point
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#