Enables re-scaling after each consecutive operation.

Default rounding mode.

Converts to a double with optional rescaling and rounding. If the precision of double is to small to express the value, rounding must be provided (either explicitly or using rounding-mode), otherwise an exception will be thrown.

Converts to a float with optional rescaling and rounding. If the precision of float is to small to express the value, rounding must be provided (either explicitly or using rounding-mode), otherwise an exception will be thrown.

Converts to an int (may cast to long on call boundaries) with optional rounding.

Converts to a long with optional rounding.

Represents the scale of a currency that is automatic and not limited to specific decimal places. Used to indicate that the scale should be determined by the actual precision of the amount, not by a fixed currency scale.

Macro version of auto-scaled?. Returns true if the given scale equals the auto-scaled sentinel value (-1). Inlines the comparison for performance.

Returns true if the given scale equals the auto-scaled sentinel value (-1).

Returns true if the scale derived from of is auto-scaled.

Uses scalable? as a soft guard (avoids strict resolution on unknown inputs).

Returns the MathContext set to handle the possible precision for the operation of dividing two BigDecimal numbers. Optional rounding mode may be provided.

Returns the maximum possible precision for the operation of dividing two BigDecimal numbers.

Enables re-scaling on some consecutive operations which support it and sets the rounding mode for operations on scaled values. Internally sets rescale-each to true and rounding-mode to the given value.

Practically, in most cases it is better to use the with-rescaling macro which also sets rounding mode.

Returns the fractional part of the given number, converted to decimal if required. Optional scale and rounding mode can be given. Makes use of rounding-mode if it’s set.

Returns the integer part of the given number, converted to decimal if required. Optional scale and rounding mode can be given. Makes use of rounding-mode if it’s set.

Applies monetary scaling rules to a BigDecimal-like value n and a currency scale.

When the scale indicates auto-scaling (equals auto-scaled, i.e., -1), the value is returned as-is (converted to BigDecimal if necessary). Otherwise, the value is scaled to the given number of decimal places.

This function is locale-independent and strict - it will throw ArithmeticException (wrapped in ExceptionInfo) if rounding is needed but no rounding mode is available.

Arguments:

• n - a value convertible to BigDecimal (number, string, BigDecimal)
• sc - target scale (long); -1 means auto-scaled (no rescaling)
• rm - optional RoundingMode for downscaling

Returns BigDecimal.

Rounding mode to round towards positive infinity.

Rounding mode to round towards zero.

Rounding mode to round towards negative infinity.

Rounding mode to round towards nearest neighbor, unless neighbors are equidistant, in which case round down.

Rounding mode to round towards nearest neighbor, unless neighbors are equidistant, in which case round towards the nearest one.

Rounding mode to round towards nearest neighbor, unless neighbors are equidistant, in which case round up.

Indication that no rounding is necessary.

Rounding mode to round away from zero.

The Scalable protocol describes values that can be scaled.

Converts the amount to a plain string, adding the M suffix when needed.

Converts the amount to a symbol, adding the M suffix when needed.

Converts the amount to a plain string.

Converts the amount to a symbol.

MathContext indicating auto-scaling and no rounding.

Alias for scale/apply.

Enables re-scaling on some consecutive operations which support it and sets the rounding mode for operations on scaled values. Internally sets *each* to true and *rounding-mode* to the given value.

The first argument should be a valid rounding (from io.randomseed.bankster.scale or java.math.RoundingMode) or one of the following:

• CEILING - rounds towards positive infinity.
• DOWN - rounds towards zero.
• FLOOR - rounds towards negative infinity.
• HALF_DOWN - rounds towards nearest neighbor unless both neighbors are equidistant, in which case rounds down.
• HALF_EVEN - rounds towards the nearest neighbor unless both neighbors are equidistant, and if so, rounds towards the even.
• HALF_UP - rounds towards the nearest neighbor unless both neighbors are equidistant, and if so, rounds up.
• UP – rounds away from zero
• UNNECESSARY - asserts that the requested operation has an exact result, hence no rounding is necessary.

Sets the rounding mode for operations on scaled values.

The first argument should be a valid rounding (from io.randomseed.bankster.scale or java.math.RoundingMode) or one of the following:

• CEILING - rounds towards positive infinity.
• DOWN - rounds towards zero.
• FLOOR - rounds towards negative infinity.
• HALF_DOWN - rounds towards nearest neighbor unless both neighbors are equidistant, in which case rounds down.
• HALF_EVEN - rounds towards the nearest neighbor unless both neighbors are equidistant, and if so, rounds towards the even.
• HALF_UP - rounds towards the nearest neighbor unless both neighbors are equidistant, and if so, rounds up.
• UP – rounds away from zero
• UNNECESSARY - asserts that the requested operation has an exact result, hence no rounding is necessary.