Return value with the specified decimal exponent.

Synopsis

Declared in <bdldfp_decimalutil.h>

static
Decimal32
quantize(
    Decimal32 value,
    int exponent);

Description

Return a number equal to the specified value (except for possible rounding) having the specified exponent. Rounding may occur when exponent is greater than the quantum of value. E.g., quantize(147e‐2_d32, ‐1) yields 15e‐1_d32. In the opposite direction, if exponent is sufficiently less than the quantum of value, it may not be possible to construct the requested result, and if so, NaN is returned. E.g., quantize(1234567e0_d32, ‐1) returns NaN. Behavior is undefined unless the exponent satisfies the following conditions * for Decimal32 type: ‐101 <= exponent <= 90 * for Decimal64 type: ‐398 <= exponent <= 369 * for Decimal128 type: ‐6176 <= exponent <= 6111

Return Value

value with the specified decimal exponent

Parameters

Name

Description

value

decimal value to quantize

exponent

desired decimal exponent

Created with MrDocs