Return value quantized to the specified exponent.

Synopsis

Declared in <bdldfp_decimalimputil.h>

static
DecimalImpUtil::ValueType32
quantize(
    ValueType32 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 quantized to the specified exponent

Parameters

Name

Description

value

value to quantize

exponent

target quantum exponent

Created with MrDocs