Struct BigDecimal

pub struct BigDecimal { /* private fields */ }

A big decimal type.

Implementations

impl BigDecimal

pub fn new(digits: BigInt, scale: i64) -> BigDecimal

Creates and initializes a BigDecimal.

The more explicit method from_bigint should be preferred, as new may change in the future.

pub fn from_bigint(digits: BigInt, scale: i64) -> BigDecimal

Construct BigDecimal from BigInt and a scale

pub fn from_biguint(digits: BigUint, scale: i64) -> BigDecimal

Construct positive BigDecimal from BigUint and a scale

pub fn to_ref(&self) -> BigDecimalRef<'_>

Make a BigDecimalRef of this value

pub fn fractional_digit_count(&self) -> i64

Returns the scale of the BigDecimal, the total number of digits to the right of the decimal point (including insignificant leading zeros)

Examples

use bigdecimal::BigDecimal;
use std::str::FromStr;

let a = BigDecimal::from(12345);  // No fractional part
let b = BigDecimal::from_str("123.45").unwrap();  // Fractional part
let c = BigDecimal::from_str("0.0000012345").unwrap();  // Completely fractional part
let d = BigDecimal::from_str("5e9").unwrap();  // Negative-fractional part

assert_eq!(a.fractional_digit_count(), 0);
assert_eq!(b.fractional_digit_count(), 2);
assert_eq!(c.fractional_digit_count(), 10);
assert_eq!(d.fractional_digit_count(), -9);

pub fn parse_bytes(buf: &[u8], radix: u32) -> Option<BigDecimal>

Creates and initializes a BigDecimal.

Decodes using str::from_utf8 and forwards to BigDecimal::from_str_radix. Only base-10 is supported.

Examples

use bigdecimal::{BigDecimal, Zero};

assert_eq!(BigDecimal::parse_bytes(b"0", 10).unwrap(), BigDecimal::zero());
assert_eq!(BigDecimal::parse_bytes(b"13", 10).unwrap(), BigDecimal::from(13));

pub fn with_scale(&self, new_scale: i64) -> BigDecimal

Return a new BigDecimal object equivalent to self, with internal scaling set to the number specified. If the new_scale is lower than the current value (indicating a larger power of 10), digits will be dropped (as precision is lower)

pub fn with_scale_round(&self, new_scale: i64, mode: RoundingMode) -> BigDecimal

Return a new BigDecimal after shortening the digits and rounding

let n: BigDecimal = "129.41675".parse().unwrap();

assert_eq!(n.with_scale_round(2, RoundingMode::Up),  "129.42".parse().unwrap());
assert_eq!(n.with_scale_round(-1, RoundingMode::Down),  "120".parse().unwrap());
assert_eq!(n.with_scale_round(4, RoundingMode::HalfEven),  "129.4168".parse().unwrap());

pub fn with_prec(&self, prec: u64) -> BigDecimal

Return a new BigDecimal object with precision set to new value

let n: BigDecimal = "129.41675".parse().unwrap();

assert_eq!(n.with_prec(2),  "130".parse().unwrap());

let n_p12 = n.with_prec(12);
let (i, scale) = n_p12.as_bigint_and_exponent();
assert_eq!(n_p12, "129.416750000".parse().unwrap());
assert_eq!(i, 129416750000_u64.into());
assert_eq!(scale, 9);

pub fn with_precision_round( &self, prec: NonZero<u64>, round: RoundingMode, ) -> BigDecimal

Return this BigDecimal with the given precision, rounding if needed

pub fn sign(&self) -> Sign

Return the sign of the BigDecimal as num::bigint::Sign.

fn sign_of(src: &str) -> Sign {
   let n: BigDecimal = src.parse().unwrap();
   n.sign()
}

assert_eq!(sign_of("-1"), Sign::Minus);
assert_eq!(sign_of("0"),  Sign::NoSign);
assert_eq!(sign_of("1"),  Sign::Plus);

pub fn as_bigint_and_exponent(&self) -> (BigInt, i64)

Return the internal big integer value and an exponent. Note that a positive exponent indicates a negative power of 10.

Examples

use bigdecimal::{BigDecimal, num_bigint::BigInt};

let n: BigDecimal = "1.23456".parse().unwrap();
let expected = ("123456".parse::<BigInt>().unwrap(), 5);
assert_eq!(n.as_bigint_and_exponent(), expected);

pub fn into_bigint_and_exponent(self) -> (BigInt, i64)

Convert into the internal big integer value and an exponent. Note that a positive exponent indicates a negative power of 10.

Examples

use bigdecimal::{BigDecimal, num_bigint::BigInt};

let n: BigDecimal = "1.23456".parse().unwrap();
let expected = ("123456".parse::<num_bigint::BigInt>().unwrap(), 5);
assert_eq!(n.into_bigint_and_exponent(), expected);

pub fn digits(&self) -> u64

Number of digits in the non-scaled integer representation

pub fn abs(&self) -> BigDecimal

Compute the absolute value of number

let n: BigDecimal = "123.45".parse().unwrap();
assert_eq!(n.abs(), "123.45".parse().unwrap());

let n: BigDecimal = "-123.45".parse().unwrap();
assert_eq!(n.abs(), "123.45".parse().unwrap());

pub fn double(&self) -> BigDecimal

Multiply decimal by 2 (efficiently)

let n: BigDecimal = "123.45".parse().unwrap();
assert_eq!(n.double(), "246.90".parse().unwrap());

pub fn half(&self) -> BigDecimal

Divide decimal by 2 (efficiently)

Note: If the last digit in the decimal is odd, the precision will increase by 1

let n: BigDecimal = "123.45".parse().unwrap();
assert_eq!(n.half(), "61.725".parse().unwrap());

pub fn square(&self) -> BigDecimal

Square a decimal: x²

No rounding or truncating of digits; this is the full result of the squaring operation.

Note: doubles the scale of bigdecimal, which might lead to accidental exponential-complexity if used in a loop.

let n: BigDecimal = "1.1156024145937225657484".parse().unwrap();
assert_eq!(n.square(), "1.24456874744734405154288399835406316085210256".parse().unwrap());

let n: BigDecimal = "-9.238597585E+84".parse().unwrap();
assert_eq!(n.square(), "8.5351685337567832225E+169".parse().unwrap());

pub fn cube(&self) -> BigDecimal

Cube a decimal: x³

No rounding or truncating of digits; this is the full result of the cubing operation.

Note: triples the scale of bigdecimal, which might lead to accidental exponential-complexity if used in a loop.

let n: BigDecimal = "1.1156024145937225657484".parse().unwrap();
assert_eq!(n.cube(), "1.388443899780141911774491376394890472130000455312878627147979955904".parse().unwrap());

let n: BigDecimal = "-9.238597585E+84".parse().unwrap();
assert_eq!(n.cube(), "-7.88529874035334084567570176625E+254".parse().unwrap());

pub fn sqrt(&self) -> Option<BigDecimal>

Take the square root of the number

Uses default-precision, set from build time environment variable

If the value is < 0, None is returned

let n: BigDecimal = "1.1156024145937225657484".parse().unwrap();
assert_eq!(n.sqrt().unwrap(), "1.056220817156016181190291268045893004363809142172289919023269377496528394924695970851558013658193913".parse().unwrap());

let n: BigDecimal = "-9.238597585E+84".parse().unwrap();
assert_eq!(n.sqrt(), None);

pub fn sqrt_with_context(&self, ctx: &Context) -> Option<BigDecimal>

Take the square root of the number, using context for precision and rounding

pub fn cbrt(&self) -> BigDecimal

Take the cube root of the number, using default context

pub fn cbrt_with_context(&self, ctx: &Context) -> BigDecimal

Take cube root of self, using properties of context

pub fn inverse(&self) -> BigDecimal

Compute the reciprical of the number: x^-1

pub fn inverse_with_context(&self, ctx: &Context) -> BigDecimal

Return inverse of self, rounding with ctx

pub fn round(&self, round_digits: i64) -> BigDecimal

Return given number rounded to ‘round_digits’ precision after the decimal point, using default rounding mode

Default rounding mode is HalfEven, but can be configured at compile-time by the environment variable: RUST_BIGDECIMAL_DEFAULT_ROUNDING_MODE (or by patching build.rs )

pub fn is_integer(&self) -> bool

Return true if this number has zero fractional part (is equal to an integer)

pub fn exp(&self) -> BigDecimal

Evaluate the natural-exponential function e^x

pub fn normalized(&self) -> BigDecimal

pub fn to_scientific_notation(&self) -> String

Create string of this bigdecimal in scientific notation

let n = BigDecimal::from(12345678);
assert_eq!(&n.to_scientific_notation(), "1.2345678e7");

pub fn write_scientific_notation<W>(&self, w: &mut W) -> Result<(), Error>

where W: Write,

Write bigdecimal in scientific notation to writer w

pub fn to_engineering_notation(&self) -> String

Create string of this bigdecimal in engineering notation

Engineering notation is scientific notation with the exponent coerced to a multiple of three

let n = BigDecimal::from(12345678);
assert_eq!(&n.to_engineering_notation(), "12.345678e6");

pub fn write_engineering_notation<W>(&self, w: &mut W) -> Result<(), Error>

where W: Write,

Write bigdecimal in engineering notation to writer w

Trait Implementations

impl Add<&i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i128) -> BigDecimal

Performs the + operation.

impl Add<&i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i128) -> BigDecimal

Performs the + operation.

impl Add<&i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i16) -> BigDecimal

Performs the + operation.

impl Add<&i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i16) -> BigDecimal

Performs the + operation.

impl Add<&i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i32) -> BigDecimal

Performs the + operation.

impl Add<&i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i32) -> BigDecimal

Performs the + operation.

impl Add<&i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i64) -> BigDecimal

Performs the + operation.

impl Add<&i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i64) -> BigDecimal

Performs the + operation.

impl Add<&i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i8) -> BigDecimal

Performs the + operation.

impl Add<&i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &i8) -> BigDecimal

Performs the + operation.

impl Add<&u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u128) -> BigDecimal

Performs the + operation.

impl Add<&u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u128) -> BigDecimal

Performs the + operation.

impl Add<&u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u16) -> BigDecimal

Performs the + operation.

impl Add<&u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u16) -> BigDecimal

Performs the + operation.

impl Add<&u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u32) -> BigDecimal

Performs the + operation.

impl Add<&u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u32) -> BigDecimal

Performs the + operation.

impl Add<&u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u64) -> BigDecimal

Performs the + operation.

impl Add<&u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u64) -> BigDecimal

Performs the + operation.

impl Add<&u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u8) -> BigDecimal

Performs the + operation.

impl Add<&u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: &u8) -> BigDecimal

Performs the + operation.

impl Add<BigDecimal> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: BigDecimal) -> BigDecimal

Performs the + operation.

impl Add<BigInt> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: BigInt) -> BigDecimal

Performs the + operation.

impl Add<BigInt> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: BigInt) -> BigDecimal

Performs the + operation.

impl<'a, T> Add<T> for &BigDecimal

where T: Into<BigDecimalRef<'a>>,

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: T) -> BigDecimal

Performs the + operation.

impl<'a, T> Add<T> for BigDecimal

where T: Into<BigDecimalRef<'a>>,

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: T) -> BigDecimal

Performs the + operation.

impl Add<i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i128) -> BigDecimal

Performs the + operation.

impl Add<i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i128) -> BigDecimal

Performs the + operation.

impl Add<i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i16) -> BigDecimal

Performs the + operation.

impl Add<i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i16) -> BigDecimal

Performs the + operation.

impl Add<i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i32) -> BigDecimal

Performs the + operation.

impl Add<i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i32) -> BigDecimal

Performs the + operation.

impl Add<i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> BigDecimal

Performs the + operation.

impl Add<i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i64) -> BigDecimal

Performs the + operation.

impl Add<i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i8) -> BigDecimal

Performs the + operation.

impl Add<i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: i8) -> BigDecimal

Performs the + operation.

impl Add<u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u128) -> BigDecimal

Performs the + operation.

impl Add<u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u128) -> BigDecimal

Performs the + operation.

impl Add<u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u16) -> BigDecimal

Performs the + operation.

impl Add<u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u16) -> BigDecimal

Performs the + operation.

impl Add<u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u32) -> BigDecimal

Performs the + operation.

impl Add<u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u32) -> BigDecimal

Performs the + operation.

impl Add<u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u64) -> BigDecimal

Performs the + operation.

impl Add<u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u64) -> BigDecimal

Performs the + operation.

impl Add<u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u8) -> BigDecimal

Performs the + operation.

impl Add<u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: u8) -> BigDecimal

Performs the + operation.

impl Add for BigDecimal

type Output = BigDecimal

The resulting type after applying the + operator.

fn add(self, rhs: BigDecimal) -> BigDecimal

Performs the + operation.

impl AddAssign<&i128> for BigDecimal

fn add_assign(&mut self, rhs: &i128)

Performs the += operation.

impl AddAssign<&i16> for BigDecimal

fn add_assign(&mut self, rhs: &i16)

Performs the += operation.

impl AddAssign<&i32> for BigDecimal

fn add_assign(&mut self, rhs: &i32)

Performs the += operation.

impl AddAssign<&i64> for BigDecimal

fn add_assign(&mut self, rhs: &i64)

Performs the += operation.

impl AddAssign<&i8> for BigDecimal

fn add_assign(&mut self, rhs: &i8)

Performs the += operation.

impl AddAssign<&u128> for BigDecimal

fn add_assign(&mut self, rhs: &u128)

Performs the += operation.

impl AddAssign<&u16> for BigDecimal

fn add_assign(&mut self, rhs: &u16)

Performs the += operation.

impl AddAssign<&u32> for BigDecimal

fn add_assign(&mut self, rhs: &u32)

Performs the += operation.

impl AddAssign<&u64> for BigDecimal

fn add_assign(&mut self, rhs: &u64)

Performs the += operation.

impl AddAssign<&u8> for BigDecimal

fn add_assign(&mut self, rhs: &u8)

Performs the += operation.

impl AddAssign<BigInt> for BigDecimal

fn add_assign(&mut self, rhs: BigInt)

Performs the += operation.

impl<'a, N> AddAssign<N> for BigDecimal

where N: Into<BigDecimalRef<'a>>,

fn add_assign(&mut self, rhs: N)

Performs the += operation.

impl AddAssign<i128> for BigDecimal

fn add_assign(&mut self, rhs: i128)

Performs the += operation.

impl AddAssign<i16> for BigDecimal

fn add_assign(&mut self, rhs: i16)

Performs the += operation.

impl AddAssign<i32> for BigDecimal

fn add_assign(&mut self, rhs: i32)

Performs the += operation.

impl AddAssign<i64> for BigDecimal

fn add_assign(&mut self, rhs: i64)

Performs the += operation.

impl AddAssign<i8> for BigDecimal

fn add_assign(&mut self, rhs: i8)

Performs the += operation.

impl AddAssign<u128> for BigDecimal

fn add_assign(&mut self, rhs: u128)

Performs the += operation.

impl AddAssign<u16> for BigDecimal

fn add_assign(&mut self, rhs: u16)

Performs the += operation.

impl AddAssign<u32> for BigDecimal

fn add_assign(&mut self, rhs: u32)

Performs the += operation.

impl AddAssign<u64> for BigDecimal

fn add_assign(&mut self, rhs: u64)

Performs the += operation.

impl AddAssign<u8> for BigDecimal

fn add_assign(&mut self, rhs: u8)

Performs the += operation.

impl AddAssign for BigDecimal

fn add_assign(&mut self, rhs: BigDecimal)

Performs the += operation.

impl Clone for BigDecimal

fn clone(&self) -> BigDecimal

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BigDecimal

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

Formats the value using the given formatter.

impl Decode<'_, MySql> for BigDecimal

fn decode( value: MySqlValueRef<'_>, ) -> Result<BigDecimal, Box<dyn Error + Sync + Send>>

Decode a new value of this type using a raw value from the database.

impl Decode<'_, Postgres> for BigDecimal

Note: NaN

BigDecimal has a greater range than NUMERIC (see the corresponding Encode impl for details) but cannot represent NaN, so decoding may return an error.

fn decode( value: PgValueRef<'_>, ) -> Result<BigDecimal, Box<dyn Error + Sync + Send>>

Decode a new value of this type using a raw value from the database.

impl Default for BigDecimal

fn default() -> BigDecimal

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for BigDecimal

fn deserialize<D>(d: D) -> Result<BigDecimal, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for BigDecimal

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

Formats the value using the given formatter.

impl<'a, 'b> Div<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, other: &BigDecimal) -> BigDecimal

Performs the / operation.

impl<'a> Div<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, other: &'a BigDecimal) -> BigDecimal

Performs the / operation.

impl Div<&f32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &f32) -> BigDecimal

Performs the / operation.

impl Div<&f64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &f64) -> BigDecimal

Performs the / operation.

impl Div<&i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &i128) -> BigDecimal

Performs the / operation.

impl Div<&i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &i16) -> BigDecimal

Performs the / operation.

impl Div<&i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &i32) -> BigDecimal

Performs the / operation.

impl Div<&i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &i64) -> BigDecimal

Performs the / operation.

impl Div<&i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &i8) -> BigDecimal

Performs the / operation.

impl Div<&u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &u128) -> BigDecimal

Performs the / operation.

impl Div<&u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &u16) -> BigDecimal

Performs the / operation.

impl Div<&u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &u32) -> BigDecimal

Performs the / operation.

impl Div<&u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &u64) -> BigDecimal

Performs the / operation.

impl Div<&u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: &u8) -> BigDecimal

Performs the / operation.

impl<'a> Div<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, other: BigDecimal) -> BigDecimal

Performs the / operation.

impl Div<f32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: f32) -> BigDecimal

Performs the / operation.

impl Div<f32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: f32) -> BigDecimal

Performs the / operation.

impl Div<f64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: f64) -> BigDecimal

Performs the / operation.

impl Div<f64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: f64) -> BigDecimal

Performs the / operation.

impl Div<i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i128) -> BigDecimal

Performs the / operation.

impl Div<i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i128) -> BigDecimal

Performs the / operation.

impl Div<i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i16) -> BigDecimal

Performs the / operation.

impl Div<i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i16) -> BigDecimal

Performs the / operation.

impl Div<i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i32) -> BigDecimal

Performs the / operation.

impl Div<i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i32) -> BigDecimal

Performs the / operation.

impl Div<i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i64) -> BigDecimal

Performs the / operation.

impl Div<i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i64) -> BigDecimal

Performs the / operation.

impl Div<i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i8) -> BigDecimal

Performs the / operation.

impl Div<i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: i8) -> BigDecimal

Performs the / operation.

impl Div<u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u128) -> BigDecimal

Performs the / operation.

impl Div<u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u128) -> BigDecimal

Performs the / operation.

impl Div<u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u16) -> BigDecimal

Performs the / operation.

impl Div<u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u16) -> BigDecimal

Performs the / operation.

impl Div<u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u32) -> BigDecimal

Performs the / operation.

impl Div<u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u32) -> BigDecimal

Performs the / operation.

impl Div<u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u64) -> BigDecimal

Performs the / operation.

impl Div<u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u64) -> BigDecimal

Performs the / operation.

impl Div<u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u8) -> BigDecimal

Performs the / operation.

impl Div<u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, denom: u8) -> BigDecimal

Performs the / operation.

impl Div for BigDecimal

type Output = BigDecimal

The resulting type after applying the / operator.

fn div(self, other: BigDecimal) -> BigDecimal

Performs the / operation.

impl DivAssign<&f32> for BigDecimal

fn div_assign(&mut self, denom: &f32)

Performs the /= operation.

impl DivAssign<&f64> for BigDecimal

fn div_assign(&mut self, denom: &f64)

Performs the /= operation.

impl DivAssign<&i128> for BigDecimal

fn div_assign(&mut self, denom: &i128)

Performs the /= operation.

impl DivAssign<&i16> for BigDecimal

fn div_assign(&mut self, denom: &i16)

Performs the /= operation.

impl DivAssign<&i32> for BigDecimal

fn div_assign(&mut self, denom: &i32)

Performs the /= operation.

impl DivAssign<&i64> for BigDecimal

fn div_assign(&mut self, denom: &i64)

Performs the /= operation.

impl DivAssign<&i8> for BigDecimal

fn div_assign(&mut self, denom: &i8)

Performs the /= operation.

impl DivAssign<&u128> for BigDecimal

fn div_assign(&mut self, denom: &u128)

Performs the /= operation.

impl DivAssign<&u16> for BigDecimal

fn div_assign(&mut self, denom: &u16)

Performs the /= operation.

impl DivAssign<&u32> for BigDecimal

fn div_assign(&mut self, denom: &u32)

Performs the /= operation.

impl DivAssign<&u64> for BigDecimal

fn div_assign(&mut self, denom: &u64)

Performs the /= operation.

impl DivAssign<&u8> for BigDecimal

fn div_assign(&mut self, denom: &u8)

Performs the /= operation.

impl DivAssign<f32> for BigDecimal

fn div_assign(&mut self, denom: f32)

Performs the /= operation.

impl DivAssign<f64> for BigDecimal

fn div_assign(&mut self, denom: f64)

Performs the /= operation.

impl DivAssign<i128> for BigDecimal

fn div_assign(&mut self, rhs: i128)

Performs the /= operation.

impl DivAssign<i16> for BigDecimal

fn div_assign(&mut self, rhs: i16)

Performs the /= operation.

impl DivAssign<i32> for BigDecimal

fn div_assign(&mut self, rhs: i32)

Performs the /= operation.

impl DivAssign<i64> for BigDecimal

fn div_assign(&mut self, rhs: i64)

Performs the /= operation.

impl DivAssign<i8> for BigDecimal

fn div_assign(&mut self, rhs: i8)

Performs the /= operation.

impl DivAssign<u128> for BigDecimal

fn div_assign(&mut self, rhs: u128)

Performs the /= operation.

impl DivAssign<u16> for BigDecimal

fn div_assign(&mut self, rhs: u16)

Performs the /= operation.

impl DivAssign<u32> for BigDecimal

fn div_assign(&mut self, rhs: u32)

Performs the /= operation.

impl DivAssign<u64> for BigDecimal

fn div_assign(&mut self, rhs: u64)

Performs the /= operation.

impl DivAssign<u8> for BigDecimal

fn div_assign(&mut self, rhs: u8)

Performs the /= operation.

impl Encode<'_, MySql> for BigDecimal

fn encode_by_ref( &self, buf: &mut Vec<u8>, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

Writes the value of self into buf without moving self.

fn encode( self, buf: &mut <DB as Database>::ArgumentBuffer<'q>, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

where Self: Sized,

Writes the value of self into buf in the expected format for the database.

fn produces(&self) -> Option<<DB as Database>::TypeInfo>

fn size_hint(&self) -> usize

impl Encode<'_, Postgres> for BigDecimal

Note: BigDecimal Has a Larger Range than NUMERIC

BigDecimal can represent values with a far, far greater range than the NUMERIC type in Postgres can.

NUMERIC is limited to 131,072 digits before the decimal point, and 16,384 digits after it. See Section 8.1, Numeric Types of the Postgres manual for details.

Meanwhile, BigDecimal can theoretically represent a value with an arbitrary number of decimal digits, albeit with a maximum of 2⁶³ significant figures.

Because encoding in the current API design must be infallible, when attempting to encode a BigDecimal that cannot fit in the wire representation of NUMERIC, SQLx may instead encode a sentinel value that falls outside the allowed range but is still representable.

This will cause the query to return a DatabaseError with code 22P03 (invalid_binary_representation) and the error message invalid scale in external "numeric" value (though this may be subject to change).

However, BigDecimal should be able to decode any NUMERIC value except NaN, for which it has no representation.

fn encode_by_ref( &self, buf: &mut PgArgumentBuffer, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

Writes the value of self into buf without moving self.

fn size_hint(&self) -> usize

fn encode( self, buf: &mut <DB as Database>::ArgumentBuffer<'q>, ) -> Result<IsNull, Box<dyn Error + Sync + Send>>

where Self: Sized,

Writes the value of self into buf in the expected format for the database.

fn produces(&self) -> Option<<DB as Database>::TypeInfo>

impl From<&i128> for BigDecimal

fn from(n: &i128) -> BigDecimal

Converts to this type from the input type.

impl From<&i16> for BigDecimal

fn from(n: &i16) -> BigDecimal

Converts to this type from the input type.

impl From<&i32> for BigDecimal

fn from(n: &i32) -> BigDecimal

Converts to this type from the input type.

impl From<&i64> for BigDecimal

fn from(n: &i64) -> BigDecimal

Converts to this type from the input type.

impl From<&i8> for BigDecimal

fn from(n: &i8) -> BigDecimal

Converts to this type from the input type.

impl From<&u128> for BigDecimal

fn from(n: &u128) -> BigDecimal

Converts to this type from the input type.

impl From<&u16> for BigDecimal

fn from(n: &u16) -> BigDecimal

Converts to this type from the input type.

impl From<&u32> for BigDecimal

fn from(n: &u32) -> BigDecimal

Converts to this type from the input type.

impl From<&u64> for BigDecimal

fn from(n: &u64) -> BigDecimal

Converts to this type from the input type.

impl From<&u8> for BigDecimal

fn from(n: &u8) -> BigDecimal

Converts to this type from the input type.

impl<T> From<(T, i64)> for BigDecimal

where T: Into<BigInt>,

fn from(_: (T, i64)) -> BigDecimal

Converts to this type from the input type.

impl From<BigDecimal> for Value

fn from(x: BigDecimal) -> Value

Converts to this type from the input type.

impl From<BigInt> for BigDecimal

fn from(int_val: BigInt) -> BigDecimal

Converts to this type from the input type.

impl From<i128> for BigDecimal

fn from(n: i128) -> BigDecimal

Converts to this type from the input type.

impl From<i16> for BigDecimal

fn from(n: i16) -> BigDecimal

Converts to this type from the input type.

impl From<i32> for BigDecimal

fn from(n: i32) -> BigDecimal

Converts to this type from the input type.

impl From<i64> for BigDecimal

fn from(n: i64) -> BigDecimal

Converts to this type from the input type.

impl From<i8> for BigDecimal

fn from(n: i8) -> BigDecimal

Converts to this type from the input type.

impl From<u128> for BigDecimal

fn from(n: u128) -> BigDecimal

Converts to this type from the input type.

impl From<u16> for BigDecimal

fn from(n: u16) -> BigDecimal

Converts to this type from the input type.

impl From<u32> for BigDecimal

fn from(n: u32) -> BigDecimal

Converts to this type from the input type.

impl From<u64> for BigDecimal

fn from(n: u64) -> BigDecimal

Converts to this type from the input type.

impl From<u8> for BigDecimal

fn from(n: u8) -> BigDecimal

Converts to this type from the input type.

impl FromPrimitive for BigDecimal

fn from_i64(n: i64) -> Option<BigDecimal>

Converts an i64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u64(n: u64) -> Option<BigDecimal>

Converts an u64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i128(n: i128) -> Option<BigDecimal>

Converts an i128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u128(n: u128) -> Option<BigDecimal>

Converts an u128 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f32(n: f32) -> Option<BigDecimal>

Converts a f32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_f64(n: f64) -> Option<BigDecimal>

Converts a f64 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_isize(n: isize) -> Option<Self>

Converts an isize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i8(n: i8) -> Option<Self>

Converts an i8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i16(n: i16) -> Option<Self>

Converts an i16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_i32(n: i32) -> Option<Self>

Converts an i32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_usize(n: usize) -> Option<Self>

Converts a usize to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u8(n: u8) -> Option<Self>

Converts an u8 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u16(n: u16) -> Option<Self>

Converts an u16 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

fn from_u32(n: u32) -> Option<Self>

Converts an u32 to return an optional value of this type. If the value cannot be represented by this type, then None is returned.

impl FromStr for BigDecimal

type Err = ParseBigDecimalError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<BigDecimal, ParseBigDecimalError>

Parses a string s to return a value of this type.

impl Hash for BigDecimal

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl LowerExp for BigDecimal

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

Formats the value using the given formatter.

impl<'a, 'b> Mul<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &BigDecimal) -> BigDecimal

Performs the * operation.

impl<'a> Mul<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &'a BigDecimal) -> BigDecimal

Performs the * operation.

impl<'a, 'b> Mul<&'a BigInt> for &'b BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &BigInt) -> BigDecimal

Performs the * operation.

impl<'a> Mul<&'a BigInt> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &BigInt) -> BigDecimal

Performs the * operation.

impl Mul<&i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i128) -> BigDecimal

Performs the * operation.

impl Mul<&i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i128) -> BigDecimal

Performs the * operation.

impl Mul<&i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i16) -> BigDecimal

Performs the * operation.

impl Mul<&i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i16) -> BigDecimal

Performs the * operation.

impl Mul<&i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i32) -> BigDecimal

Performs the * operation.

impl Mul<&i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i32) -> BigDecimal

Performs the * operation.

impl Mul<&i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i64) -> BigDecimal

Performs the * operation.

impl Mul<&i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i64) -> BigDecimal

Performs the * operation.

impl Mul<&i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i8) -> BigDecimal

Performs the * operation.

impl Mul<&i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &i8) -> BigDecimal

Performs the * operation.

impl Mul<&u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u128) -> BigDecimal

Performs the * operation.

impl Mul<&u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u128) -> BigDecimal

Performs the * operation.

impl Mul<&u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u16) -> BigDecimal

Performs the * operation.

impl Mul<&u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u16) -> BigDecimal

Performs the * operation.

impl Mul<&u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u32) -> BigDecimal

Performs the * operation.

impl Mul<&u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u32) -> BigDecimal

Performs the * operation.

impl Mul<&u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u64) -> BigDecimal

Performs the * operation.

impl Mul<&u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u64) -> BigDecimal

Performs the * operation.

impl Mul<&u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u8) -> BigDecimal

Performs the * operation.

impl Mul<&u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: &u8) -> BigDecimal

Performs the * operation.

impl<'a> Mul<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: BigDecimal) -> BigDecimal

Performs the * operation.

impl<'a> Mul<BigInt> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: BigInt) -> BigDecimal

Performs the * operation.

impl Mul<BigInt> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: BigInt) -> BigDecimal

Performs the * operation.

impl Mul<i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i128) -> BigDecimal

Performs the * operation.

impl Mul<i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i128) -> BigDecimal

Performs the * operation.

impl Mul<i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i16) -> BigDecimal

Performs the * operation.

impl Mul<i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i16) -> BigDecimal

Performs the * operation.

impl Mul<i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> BigDecimal

Performs the * operation.

impl Mul<i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i32) -> BigDecimal

Performs the * operation.

impl Mul<i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> BigDecimal

Performs the * operation.

impl Mul<i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i64) -> BigDecimal

Performs the * operation.

impl Mul<i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i8) -> BigDecimal

Performs the * operation.

impl Mul<i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: i8) -> BigDecimal

Performs the * operation.

impl Mul<u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u128) -> BigDecimal

Performs the * operation.

impl Mul<u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u128) -> BigDecimal

Performs the * operation.

impl Mul<u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u16) -> BigDecimal

Performs the * operation.

impl Mul<u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u16) -> BigDecimal

Performs the * operation.

impl Mul<u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u32) -> BigDecimal

Performs the * operation.

impl Mul<u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u32) -> BigDecimal

Performs the * operation.

impl Mul<u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> BigDecimal

Performs the * operation.

impl Mul<u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u64) -> BigDecimal

Performs the * operation.

impl Mul<u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u8) -> BigDecimal

Performs the * operation.

impl Mul<u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: u8) -> BigDecimal

Performs the * operation.

impl Mul for BigDecimal

type Output = BigDecimal

The resulting type after applying the * operator.

fn mul(self, rhs: BigDecimal) -> BigDecimal

Performs the * operation.

impl<'a> MulAssign<&'a BigDecimal> for BigDecimal

fn mul_assign(&mut self, rhs: &BigDecimal)

Performs the *= operation.

impl<'a> MulAssign<&'a BigInt> for BigDecimal

fn mul_assign(&mut self, rhs: &BigInt)

Performs the *= operation.

impl MulAssign<&i128> for BigDecimal

fn mul_assign(&mut self, rhs: &i128)

Performs the *= operation.

impl MulAssign<&i16> for BigDecimal

fn mul_assign(&mut self, rhs: &i16)

Performs the *= operation.

impl MulAssign<&i32> for BigDecimal

fn mul_assign(&mut self, rhs: &i32)

Performs the *= operation.

impl MulAssign<&i64> for BigDecimal

fn mul_assign(&mut self, rhs: &i64)

Performs the *= operation.

impl MulAssign<&i8> for BigDecimal

fn mul_assign(&mut self, rhs: &i8)

Performs the *= operation.

impl MulAssign<&u128> for BigDecimal

fn mul_assign(&mut self, rhs: &u128)

Performs the *= operation.

impl MulAssign<&u16> for BigDecimal

fn mul_assign(&mut self, rhs: &u16)

Performs the *= operation.

impl MulAssign<&u32> for BigDecimal

fn mul_assign(&mut self, rhs: &u32)

Performs the *= operation.

impl MulAssign<&u64> for BigDecimal

fn mul_assign(&mut self, rhs: &u64)

Performs the *= operation.

impl MulAssign<&u8> for BigDecimal

fn mul_assign(&mut self, rhs: &u8)

Performs the *= operation.

impl MulAssign<BigInt> for BigDecimal

fn mul_assign(&mut self, rhs: BigInt)

Performs the *= operation.

impl MulAssign<i128> for BigDecimal

fn mul_assign(&mut self, rhs: i128)

Performs the *= operation.

impl MulAssign<i16> for BigDecimal

fn mul_assign(&mut self, rhs: i16)

Performs the *= operation.

impl MulAssign<i32> for BigDecimal

fn mul_assign(&mut self, rhs: i32)

Performs the *= operation.

impl MulAssign<i64> for BigDecimal

fn mul_assign(&mut self, rhs: i64)

Performs the *= operation.

impl MulAssign<i8> for BigDecimal

fn mul_assign(&mut self, rhs: i8)

Performs the *= operation.

impl MulAssign<u128> for BigDecimal

fn mul_assign(&mut self, rhs: u128)

Performs the *= operation.

impl MulAssign<u16> for BigDecimal

fn mul_assign(&mut self, rhs: u16)

Performs the *= operation.

impl MulAssign<u32> for BigDecimal

fn mul_assign(&mut self, rhs: u32)

Performs the *= operation.

impl MulAssign<u64> for BigDecimal

fn mul_assign(&mut self, rhs: u64)

Performs the *= operation.

impl MulAssign<u8> for BigDecimal

fn mul_assign(&mut self, rhs: u8)

Performs the *= operation.

impl MulAssign for BigDecimal

fn mul_assign(&mut self, other: BigDecimal)

Performs the *= operation.

impl<'a> Neg for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn neg(self) -> BigDecimal

Performs the unary - operation.

impl Neg for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn neg(self) -> BigDecimal

Performs the unary - operation.

impl Nullable for BigDecimal

fn null() -> Value

impl Num for BigDecimal

fn from_str_radix( s: &str, radix: u32, ) -> Result<BigDecimal, ParseBigDecimalError>

Creates and initializes a BigDecimal.

type FromStrRadixErr = ParseBigDecimalError

impl One for BigDecimal

fn one() -> BigDecimal

Returns the multiplicative identity element of Self, 1.

fn set_one(&mut self)

Sets self to the multiplicative identity element of Self, 1.

fn is_one(&self) -> bool

where Self: PartialEq,

Returns true if self is equal to the multiplicative identity.

impl Ord for BigDecimal

fn cmp(&self, other: &BigDecimal) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for BigDecimal

fn eq(&self, rhs: &BigDecimal) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for BigDecimal

fn partial_cmp(&self, other: &BigDecimal) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PgHasArrayType for BigDecimal

fn array_type_info() -> PgTypeInfo

fn array_compatible(ty: &PgTypeInfo) -> bool

impl<'a, 'b> Rem<&'b BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator.

fn rem(self, other: &BigDecimal) -> BigDecimal

Performs the % operation.

impl<'a> Rem<&'a BigDecimal> for BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator.

fn rem(self, other: &BigDecimal) -> BigDecimal

Performs the % operation.

impl<'a> Rem<BigDecimal> for &'a BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator.

fn rem(self, other: BigDecimal) -> BigDecimal

Performs the % operation.

impl Rem for BigDecimal

type Output = BigDecimal

The resulting type after applying the % operator.

fn rem(self, other: BigDecimal) -> BigDecimal

Performs the % operation.

impl RemAssign<&BigDecimal> for BigDecimal

fn rem_assign(&mut self, other: &BigDecimal)

Performs the %= operation.

impl Serialize for BigDecimal

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Signed for BigDecimal

fn abs(&self) -> BigDecimal

Computes the absolute value.

fn abs_sub(&self, other: &BigDecimal) -> BigDecimal

The positive difference of two numbers.

fn signum(&self) -> BigDecimal

Returns the sign of the number.

fn is_positive(&self) -> bool

Returns true if the number is positive and false if the number is zero or negative.

fn is_negative(&self) -> bool

Returns true if the number is negative and false if the number is zero or positive.

impl Sub<&i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i128) -> BigDecimal

Performs the - operation.

impl Sub<&i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i128) -> BigDecimal

Performs the - operation.

impl Sub<&i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i16) -> BigDecimal

Performs the - operation.

impl Sub<&i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i16) -> BigDecimal

Performs the - operation.

impl Sub<&i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i32) -> BigDecimal

Performs the - operation.

impl Sub<&i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i32) -> BigDecimal

Performs the - operation.

impl Sub<&i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i64) -> BigDecimal

Performs the - operation.

impl Sub<&i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i64) -> BigDecimal

Performs the - operation.

impl Sub<&i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i8) -> BigDecimal

Performs the - operation.

impl Sub<&i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &i8) -> BigDecimal

Performs the - operation.

impl Sub<&u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u128) -> BigDecimal

Performs the - operation.

impl Sub<&u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u128) -> BigDecimal

Performs the - operation.

impl Sub<&u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u16) -> BigDecimal

Performs the - operation.

impl Sub<&u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u16) -> BigDecimal

Performs the - operation.

impl Sub<&u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u32) -> BigDecimal

Performs the - operation.

impl Sub<&u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u32) -> BigDecimal

Performs the - operation.

impl Sub<&u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u64) -> BigDecimal

Performs the - operation.

impl Sub<&u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u64) -> BigDecimal

Performs the - operation.

impl Sub<&u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u8) -> BigDecimal

Performs the - operation.

impl Sub<&u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: &u8) -> BigDecimal

Performs the - operation.

impl Sub<BigDecimal> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: BigDecimal) -> BigDecimal

Performs the - operation.

impl Sub<BigInt> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: BigInt) -> BigDecimal

Performs the - operation.

impl Sub<BigInt> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: BigInt) -> BigDecimal

Performs the - operation.

impl<'a, T> Sub<T> for &BigDecimal

where T: Into<BigDecimalRef<'a>>,

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> BigDecimal

Performs the - operation.

impl<'a, T> Sub<T> for BigDecimal

where T: Into<BigDecimalRef<'a>>,

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: T) -> BigDecimal

Performs the - operation.

impl Sub<i128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i128) -> BigDecimal

Performs the - operation.

impl Sub<i128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i128) -> BigDecimal

Performs the - operation.

impl Sub<i16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i16) -> BigDecimal

Performs the - operation.

impl Sub<i16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i16) -> BigDecimal

Performs the - operation.

impl Sub<i32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i32) -> BigDecimal

Performs the - operation.

impl Sub<i32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i32) -> BigDecimal

Performs the - operation.

impl Sub<i64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> BigDecimal

Performs the - operation.

impl Sub<i64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i64) -> BigDecimal

Performs the - operation.

impl Sub<i8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i8) -> BigDecimal

Performs the - operation.

impl Sub<i8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: i8) -> BigDecimal

Performs the - operation.

impl Sub<u128> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u128) -> BigDecimal

Performs the - operation.

impl Sub<u128> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u128) -> BigDecimal

Performs the - operation.

impl Sub<u16> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u16) -> BigDecimal

Performs the - operation.

impl Sub<u16> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u16) -> BigDecimal

Performs the - operation.

impl Sub<u32> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u32) -> BigDecimal

Performs the - operation.

impl Sub<u32> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u32) -> BigDecimal

Performs the - operation.

impl Sub<u64> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u64) -> BigDecimal

Performs the - operation.

impl Sub<u64> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u64) -> BigDecimal

Performs the - operation.

impl Sub<u8> for &BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u8) -> BigDecimal

Performs the - operation.

impl Sub<u8> for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: u8) -> BigDecimal

Performs the - operation.

impl Sub for BigDecimal

type Output = BigDecimal

The resulting type after applying the - operator.

fn sub(self, rhs: BigDecimal) -> BigDecimal

Performs the - operation.

impl SubAssign<&i128> for BigDecimal

fn sub_assign(&mut self, rhs: &i128)

Performs the -= operation.

impl SubAssign<&i16> for BigDecimal

fn sub_assign(&mut self, rhs: &i16)

Performs the -= operation.

impl SubAssign<&i32> for BigDecimal

fn sub_assign(&mut self, rhs: &i32)

Performs the -= operation.

impl SubAssign<&i64> for BigDecimal

fn sub_assign(&mut self, rhs: &i64)

Performs the -= operation.

impl SubAssign<&i8> for BigDecimal

fn sub_assign(&mut self, rhs: &i8)

Performs the -= operation.

impl SubAssign<&u128> for BigDecimal

fn sub_assign(&mut self, rhs: &u128)

Performs the -= operation.

impl SubAssign<&u16> for BigDecimal

fn sub_assign(&mut self, rhs: &u16)

Performs the -= operation.

impl SubAssign<&u32> for BigDecimal

fn sub_assign(&mut self, rhs: &u32)

Performs the -= operation.

impl SubAssign<&u64> for BigDecimal

fn sub_assign(&mut self, rhs: &u64)

Performs the -= operation.

impl SubAssign<&u8> for BigDecimal

fn sub_assign(&mut self, rhs: &u8)

Performs the -= operation.

impl SubAssign<BigInt> for BigDecimal

fn sub_assign(&mut self, rhs: BigInt)

Performs the -= operation.

impl<'rhs, T> SubAssign<T> for BigDecimal

where T: Into<BigDecimalRef<'rhs>>,

fn sub_assign(&mut self, rhs: T)

Performs the -= operation.

impl SubAssign<i128> for BigDecimal

fn sub_assign(&mut self, rhs: i128)

Performs the -= operation.

impl SubAssign<i16> for BigDecimal

fn sub_assign(&mut self, rhs: i16)

Performs the -= operation.

impl SubAssign<i32> for BigDecimal

fn sub_assign(&mut self, rhs: i32)

Performs the -= operation.

impl SubAssign<i64> for BigDecimal

fn sub_assign(&mut self, rhs: i64)

Performs the -= operation.

impl SubAssign<i8> for BigDecimal

fn sub_assign(&mut self, rhs: i8)

Performs the -= operation.

impl SubAssign<u128> for BigDecimal

fn sub_assign(&mut self, rhs: u128)

Performs the -= operation.

impl SubAssign<u16> for BigDecimal

fn sub_assign(&mut self, rhs: u16)

Performs the -= operation.

impl SubAssign<u32> for BigDecimal

fn sub_assign(&mut self, rhs: u32)

Performs the -= operation.

impl SubAssign<u64> for BigDecimal

fn sub_assign(&mut self, rhs: u64)

Performs the -= operation.

impl SubAssign<u8> for BigDecimal

fn sub_assign(&mut self, rhs: u8)

Performs the -= operation.

impl SubAssign for BigDecimal

fn sub_assign(&mut self, rhs: BigDecimal)

Performs the -= operation.

impl<'a> Sum<&'a BigDecimal> for BigDecimal

fn sum<I>(iter: I) -> BigDecimal

where I: Iterator<Item = &'a BigDecimal>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum for BigDecimal

fn sum<I>(iter: I) -> BigDecimal

where I: Iterator<Item = BigDecimal>,

Takes an iterator and generates Self from the elements by “summing up” the items.

impl ToBigInt for BigDecimal

fn to_bigint(&self) -> Option<BigInt>

Converts the value of self to a BigInt.

impl ToPrimitive for BigDecimal

fn to_i64(&self) -> Option<i64>

Converts the value of self to an i64. If the value cannot be represented by an i64, then None is returned.

fn to_i128(&self) -> Option<i128>

Converts the value of self to an i128. If the value cannot be represented by an i128 (i64 under the default implementation), then None is returned.

fn to_u64(&self) -> Option<u64>

Converts the value of self to a u64. If the value cannot be represented by a u64, then None is returned.

fn to_u128(&self) -> Option<u128>

Converts the value of self to a u128. If the value cannot be represented by a u128 (u64 under the default implementation), then None is returned.

fn to_f64(&self) -> Option<f64>

Converts the value of self to an f64. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f64.

fn to_isize(&self) -> Option<isize>

Converts the value of self to an isize. If the value cannot be represented by an isize, then None is returned.

fn to_i8(&self) -> Option<i8>

Converts the value of self to an i8. If the value cannot be represented by an i8, then None is returned.

fn to_i16(&self) -> Option<i16>

Converts the value of self to an i16. If the value cannot be represented by an i16, then None is returned.

fn to_i32(&self) -> Option<i32>

Converts the value of self to an i32. If the value cannot be represented by an i32, then None is returned.

fn to_usize(&self) -> Option<usize>

Converts the value of self to a usize. If the value cannot be represented by a usize, then None is returned.

fn to_u8(&self) -> Option<u8>

Converts the value of self to a u8. If the value cannot be represented by a u8, then None is returned.

fn to_u16(&self) -> Option<u16>

Converts the value of self to a u16. If the value cannot be represented by a u16, then None is returned.

fn to_u32(&self) -> Option<u32>

Converts the value of self to a u32. If the value cannot be represented by a u32, then None is returned.

fn to_f32(&self) -> Option<f32>

Converts the value of self to an f32. Overflows may map to positive or negative inifinity, otherwise None is returned if the value cannot be represented by an f32.

impl TryFrom<&PgNumeric> for BigDecimal

type Error = Box<dyn Error + Sync + Send>

The type returned in the event of a conversion error.

fn try_from( numeric: &PgNumeric, ) -> Result<BigDecimal, <BigDecimal as TryFrom<&PgNumeric>>::Error>

Performs the conversion.

impl TryFrom<PgNumeric> for BigDecimal

type Error = Box<dyn Error + Sync + Send>

The type returned in the event of a conversion error.

fn try_from( numeric: PgNumeric, ) -> Result<BigDecimal, Box<dyn Error + Sync + Send>>

Performs the conversion.

impl TryFrom<f32> for BigDecimal

type Error = ParseBigDecimalError

The type returned in the event of a conversion error.

fn try_from(n: f32) -> Result<BigDecimal, <BigDecimal as TryFrom<f32>>::Error>

Performs the conversion.

impl TryFrom<f64> for BigDecimal

type Error = ParseBigDecimalError

The type returned in the event of a conversion error.

fn try_from(n: f64) -> Result<BigDecimal, <BigDecimal as TryFrom<f64>>::Error>

Performs the conversion.

impl TryGetable for BigDecimal

fn try_get_by<I: ColIdx>(res: &QueryResult, idx: I) -> Result<Self, TryGetError>

Get a value from the query result with an ColIdx

fn try_get(res: &QueryResult, pre: &str, col: &str) -> Result<Self, TryGetError>

Get a value from the query result with prefixed column name

fn try_get_by_index( res: &QueryResult, index: usize, ) -> Result<Self, TryGetError>

Get a value from the query result based on the order in the select expressions

impl Type<MySql> for BigDecimal

fn type_info() -> MySqlTypeInfo

Returns the canonical SQL type for this Rust type.

fn compatible(ty: &MySqlTypeInfo) -> bool

Determines if this Rust type is compatible with the given SQL type.

impl Type<Postgres> for BigDecimal

fn type_info() -> PgTypeInfo

Returns the canonical SQL type for this Rust type.

fn compatible(ty: &<DB as Database>::TypeInfo) -> bool

Determines if this Rust type is compatible with the given SQL type.

impl UpperExp for BigDecimal

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

Formats the value using the given formatter.

impl ValueType for BigDecimal

fn try_from(v: Value) -> Result<BigDecimal, ValueTypeErr>

fn type_name() -> String

fn array_type() -> ArrayType

fn column_type() -> ColumnType

fn unwrap(v: Value) -> Self

fn expect(v: Value, msg: &str) -> Self

impl Zero for BigDecimal

fn zero() -> BigDecimal

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.

impl Eq for BigDecimal

impl NotU8 for BigDecimal