Struct Context

pub struct Context { /* private fields */ }

Mathematical Context

Stores rules for numerical operations, such as how to round and number of digits to keep.

Defaults are defined at compile time, determined by environment variables:

Variable	Descripiton	default
RUST_BIGDECIMAL_DEFAULT_PRECISION	digit precision	100
RUST_BIGDECIMAL_DEFAULT_ROUNDING_MODE	rounding-mode	HalfEven

It is recommended that the user set explicit values of a Context and not rely on compile time constants, but the option is there if necessary.

Implementations

impl Context

pub fn new(precision: NonZeroU64, rounding: RoundingMode) -> Self

Create context with precision and rounding mode

pub fn with_precision(&self, precision: NonZeroU64) -> Self

Copy context with new precision value

pub fn with_prec<T: ToPrimitive>(&self, precision: T) -> Option<Self>

Copy context with new precision value

pub fn with_rounding_mode(&self, mode: RoundingMode) -> Self

Copy context with new rounding mode

pub fn precision(&self) -> NonZeroU64

Return maximum precision

pub fn rounding_mode(&self) -> RoundingMode

Return rounding mode

pub fn round_decimal(&self, n: BigDecimal) -> BigDecimal

Round decimal to precision in this context, using rounding-mode

pub fn round_decimal_ref<'a, D: Into<BigDecimalRef<'a>>>( &self, n: D, ) -> BigDecimal

Round decimal to precision in this context, using rounding-mode

impl Context

pub fn add_refs<'a, 'b, A, B>(&self, a: A, b: B) -> BigDecimal

where A: Into<BigDecimalRef<'a>>, B: Into<BigDecimalRef<'b>>,

Add two big digit references

pub fn add_refs_into<'a, 'b, A, B>(&self, a: A, b: B, dest: &mut BigDecimal)

where A: Into<BigDecimalRef<'a>>, B: Into<BigDecimalRef<'b>>,

Add two decimal refs, storing value in dest

Trait Implementations

impl Clone for Context

fn clone(&self) -> Context

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Context

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Context

fn default() -> Self

Returns the “default value” for a type.