[#BloombergLP-bdldfp-DecimalUtil-quantizeEqual-02]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdldfp.adoc[bdldfp]::xref:BloombergLP/bdldfp/DecimalUtil.adoc[DecimalUtil]::quantizeEqual
:relfileprefix: ../../../
:mrdocs:

If a floating‐point number equal to the specified `y` and having the specified `exponent` can be constructed, set that value into the specified `x` and return 0. Otherwise, or if `y` is NaN or infinity, leave the contents of `x` unchanged and return a non‐zero value. The behavior is undefined unless `exponent` satisfies the following conditions * for `Decimal32` type: `‐101 <= exponent <= 90` * for `Decimal64` type: `‐398 <= exponent <= 369` * for `Decimal128` type: `‐6176 <= exponent <= 6111`

== Synopsis

Declared in `<bdldfp_decimalutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
quantizeEqual(
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32]* x,
    xref:BloombergLP/bdldfp/Decimal32.adoc[Decimal32] y,
    int exponent);
----

== Description

Example: `Decimal32 x;` `BSLS_ASSERT(0 == quantizeEqual(&x, 123e+3_d32, 2);` `BSLS_ASSERT(1230e+2_d32 == x);` `BSLS_ASSERT(0 != quantizeEqual(&x, 123e+3_d32, ‐2);` `BSLS_ASSERT(1230e+2_d32 == x);`


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