Struct sea_orm::entity::prelude::Decimal

pub struct Decimal { /* fields omitted */ }

Decimal represents a 128 bit representation of a fixed-precision decimal number. The finite set of values of type Decimal are of the form m / 10^e, where m is an integer such that -2⁹⁶ < m < 2⁹⁶, and e is an integer between 0 and 28 inclusive.

Implementations

impl Decimal

pub const MIN: Decimal

The smallest value that can be represented by this decimal type.

pub const MAX: Decimal

The largest value that can be represented by this decimal type.

pub const ZERO: Decimal

A constant representing 0.

pub const ONE: Decimal

A constant representing 1.

pub const NEGATIVE_ONE: Decimal

A constant representing -1.

pub const TWO: Decimal

A constant representing 2.

pub const TEN: Decimal

A constant representing 10.

pub const ONE_HUNDRED: Decimal

A constant representing 100.

pub const ONE_THOUSAND: Decimal

A constant representing 1000.

pub fn new(num: i64, scale: u32) -> Decimal

Returns a Decimal with a 64 bit m representation and corresponding e scale.

Arguments

• num - An i64 that represents the m portion of the decimal number
• scale - A u32 representing the e portion of the decimal number.

Panics

This function panics if scale is > 28.

Example

use rust_decimal::Decimal;

let pi = Decimal::new(3141, 3);
assert_eq!(pi.to_string(), "3.141");

pub const fn try_new(num: i64, scale: u32) -> Result<Decimal, Error>

Checked version of Decimal::new. Will return Err instead of panicking at run-time.

Example

use rust_decimal::Decimal;

let max = Decimal::try_new(i64::MAX, u32::MAX);
assert!(max.is_err());

pub fn from_i128_with_scale(num: i128, scale: u32) -> Decimal

Creates a Decimal using a 128 bit signed m representation and corresponding e scale.

Arguments

• num - An i128 that represents the m portion of the decimal number
• scale - A u32 representing the e portion of the decimal number.

Panics

This function panics if scale is > 28 or if num exceeds the maximum supported 96 bits.

Example

use rust_decimal::Decimal;

let pi = Decimal::from_i128_with_scale(3141i128, 3);
assert_eq!(pi.to_string(), "3.141");

pub const fn try_from_i128_with_scale(
    num: i128,
    scale: u32
) -> Result<Decimal, Error>

Checked version of Decimal::from_i128_with_scale. Will return Err instead of panicking at run-time.

Example

use rust_decimal::Decimal;

let max = Decimal::try_from_i128_with_scale(i128::MAX, u32::MAX);
assert!(max.is_err());

pub const fn from_parts(
    lo: u32,
    mid: u32,
    hi: u32,
    negative: bool,
    scale: u32
) -> Decimal

Returns a Decimal using the instances constituent parts.

Arguments

• lo - The low 32 bits of a 96-bit integer.
• mid - The middle 32 bits of a 96-bit integer.
• hi - The high 32 bits of a 96-bit integer.
• negative - true to indicate a negative number.
• scale - A power of 10 ranging from 0 to 28.

Caution: Undefined behavior

While a scale greater than 28 can be passed in, it will be automatically capped by this function at the maximum precision. The library opts towards this functionality as opposed to a panic to ensure that the function can be treated as constant. This may lead to undefined behavior in downstream applications and should be treated with caution.

Example

use rust_decimal::Decimal;

let pi = Decimal::from_parts(1102470952, 185874565, 1703060790, false, 28);
assert_eq!(pi.to_string(), "3.1415926535897932384626433832");

pub fn from_scientific(value: &str) -> Result<Decimal, Error>

Returns a Result which if successful contains the Decimal constitution of the scientific notation provided by value.

Arguments

• value - The scientific notation of the Decimal.

Example

use rust_decimal::Decimal;

let value = Decimal::from_scientific("9.7e-7").unwrap();
assert_eq!(value.to_string(), "0.00000097");

pub const fn scale(&self) -> u32

Returns the scale of the decimal number, otherwise known as e.

Example

use rust_decimal::Decimal;

let num = Decimal::new(1234, 3);
assert_eq!(num.scale(), 3u32);

pub const fn mantissa(&self) -> i128

Returns the mantissa of the decimal number.

Example

use rust_decimal::prelude::*;

let num = Decimal::from_str("-1.2345678").unwrap();
assert_eq!(num.mantissa(), -12345678i128);
assert_eq!(num.scale(), 7);

pub const fn is_zero(&self) -> bool

Returns true if this Decimal number is equivalent to zero.

Example

use rust_decimal::prelude::*;

let num = Decimal::ZERO;
assert!(num.is_zero());

pub fn set_sign(&mut self, positive: bool)

👎 Deprecated since 1.4.0:

please use set_sign_positive instead

An optimized method for changing the sign of a decimal number.

Arguments

• positive: true if the resulting decimal should be positive.

Example

use rust_decimal::Decimal;

let mut one = Decimal::ONE;
one.set_sign(false);
assert_eq!(one.to_string(), "-1");

pub fn set_sign_positive(&mut self, positive: bool)

An optimized method for changing the sign of a decimal number.

Arguments

• positive: true if the resulting decimal should be positive.

Example

use rust_decimal::Decimal;

let mut one = Decimal::ONE;
one.set_sign_positive(false);
assert_eq!(one.to_string(), "-1");

pub fn set_sign_negative(&mut self, negative: bool)

An optimized method for changing the sign of a decimal number.

Arguments

• negative: true if the resulting decimal should be negative.

Example

use rust_decimal::Decimal;

let mut one = Decimal::ONE;
one.set_sign_negative(true);
assert_eq!(one.to_string(), "-1");

pub fn set_scale(&mut self, scale: u32) -> Result<(), Error>

An optimized method for changing the scale of a decimal number.

Arguments

• scale: the new scale of the number

Example

use rust_decimal::Decimal;

let mut one = Decimal::ONE;
one.set_scale(5).unwrap();
assert_eq!(one.to_string(), "0.00001");

pub fn rescale(&mut self, scale: u32)

Modifies the Decimal to the given scale, attempting to do so without changing the underlying number itself.

Note that setting the scale to something less then the current Decimals scale will cause the newly created Decimal to have some rounding. Scales greater than the maximum precision supported by Decimal will be automatically rounded to Decimal::MAX_PRECISION. Rounding leverages the half up strategy.

Arguments

• scale: The scale to use for the new Decimal number.

Example

use rust_decimal::prelude::*;

// Rescaling to a higher scale preserves the value
let mut number = Decimal::from_str("1.123").unwrap();
assert_eq!(number.scale(), 3);
number.rescale(6);
assert_eq!(number.to_string(), "1.123000");
assert_eq!(number.scale(), 6);

// Rescaling to a lower scale forces the number to be rounded
let mut number = Decimal::from_str("1.45").unwrap();
assert_eq!(number.scale(), 2);
number.rescale(1);
assert_eq!(number.to_string(), "1.5");
assert_eq!(number.scale(), 1);

pub const fn serialize(&self) -> [u8; 16]

Returns a serialized version of the decimal number. The resulting byte array will have the following representation:

• Bytes 1-4: flags
• Bytes 5-8: lo portion of m
• Bytes 9-12: mid portion of m
• Bytes 13-16: high portion of m

pub const fn deserialize(bytes: [u8; 16]) -> Decimal

Deserializes the given bytes into a decimal number. The deserialized byte representation must be 16 bytes and adhere to the following convention:

• Bytes 1-4: flags
• Bytes 5-8: lo portion of m
• Bytes 9-12: mid portion of m
• Bytes 13-16: high portion of m

pub fn is_negative(&self) -> bool

👎 Deprecated since 0.6.3:

please use is_sign_negative instead

Returns true if the decimal is negative.

pub fn is_positive(&self) -> bool

👎 Deprecated since 0.6.3:

please use is_sign_positive instead

Returns true if the decimal is positive.

pub const fn is_sign_negative(&self) -> bool

Returns true if the sign bit of the decimal is negative.

pub const fn is_sign_positive(&self) -> bool

Returns true if the sign bit of the decimal is positive.

pub const fn min_value() -> Decimal

👎 Deprecated since 1.12.0:

Use the associated constant Decimal::MIN

Returns the minimum possible number that Decimal can represent.

pub const fn max_value() -> Decimal

👎 Deprecated since 1.12.0:

Use the associated constant Decimal::MAX

Returns the maximum possible number that Decimal can represent.

pub fn trunc(&self) -> Decimal

Returns a new Decimal integral with no fractional portion. This is a true truncation whereby no rounding is performed.

Example

use rust_decimal::Decimal;

let pi = Decimal::new(3141, 3);
let trunc = Decimal::new(3, 0);
// note that it returns a decimal
assert_eq!(pi.trunc(), trunc);

pub fn fract(&self) -> Decimal

Returns a new Decimal representing the fractional portion of the number.

Example

use rust_decimal::Decimal;

let pi = Decimal::new(3141, 3);
let fract = Decimal::new(141, 3);
// note that it returns a decimal
assert_eq!(pi.fract(), fract);

pub fn abs(&self) -> Decimal

Computes the absolute value of self.

Example

use rust_decimal::Decimal;

let num = Decimal::new(-3141, 3);
assert_eq!(num.abs().to_string(), "3.141");

pub fn floor(&self) -> Decimal

Returns the largest integer less than or equal to a number.

Example

use rust_decimal::Decimal;

let num = Decimal::new(3641, 3);
assert_eq!(num.floor().to_string(), "3");

pub fn ceil(&self) -> Decimal

Returns the smallest integer greater than or equal to a number.

Example

use rust_decimal::Decimal;

let num = Decimal::new(3141, 3);
assert_eq!(num.ceil().to_string(), "4");
let num = Decimal::new(3, 0);
assert_eq!(num.ceil().to_string(), "3");

pub fn max(self, other: Decimal) -> Decimal

Returns the maximum of the two numbers.

use rust_decimal::Decimal;

let x = Decimal::new(1, 0);
let y = Decimal::new(2, 0);
assert_eq!(y, x.max(y));

pub fn min(self, other: Decimal) -> Decimal

Returns the minimum of the two numbers.

use rust_decimal::Decimal;

let x = Decimal::new(1, 0);
let y = Decimal::new(2, 0);
assert_eq!(x, x.min(y));

pub fn normalize(&self) -> Decimal

Strips any trailing zero’s from a Decimal and converts -0 to 0.

Example

use rust_decimal::prelude::*;

let number = Decimal::from_str("3.100").unwrap();
assert_eq!(number.normalize().to_string(), "3.1");

pub fn normalize_assign(&mut self)

An in place version of normalize. Strips any trailing zero’s from a Decimal and converts -0 to 0.

Example

use rust_decimal::prelude::*;

let mut number = Decimal::from_str("3.100").unwrap();
assert_eq!(number.to_string(), "3.100");
number.normalize_assign();
assert_eq!(number.to_string(), "3.1");

pub fn round(&self) -> Decimal

Returns a new Decimal number with no fractional portion (i.e. an integer). Rounding currently follows “Bankers Rounding” rules. e.g. 6.5 -> 6, 7.5 -> 8

Example

use rust_decimal::Decimal;

// Demonstrating bankers rounding...
let number_down = Decimal::new(65, 1);
let number_up   = Decimal::new(75, 1);
assert_eq!(number_down.round().to_string(), "6");
assert_eq!(number_up.round().to_string(), "8");

pub fn round_dp_with_strategy(
    &self,
    dp: u32,
    strategy: RoundingStrategy
) -> Decimal

Returns a new Decimal number with the specified number of decimal points for fractional portion. Rounding is performed using the provided RoundingStrategy

Arguments

• dp: the number of decimal points to round to.
• strategy: the RoundingStrategy to use.

Example

use rust_decimal::{Decimal, RoundingStrategy};
use core::str::FromStr;

let tax = Decimal::from_str("3.4395").unwrap();
assert_eq!(tax.round_dp_with_strategy(2, RoundingStrategy::MidpointAwayFromZero).to_string(), "3.44");

pub fn round_dp(&self, dp: u32) -> Decimal

Returns a new Decimal number with the specified number of decimal points for fractional portion. Rounding currently follows “Bankers Rounding” rules. e.g. 6.5 -> 6, 7.5 -> 8

Arguments

• dp: the number of decimal points to round to.

Example

use rust_decimal::Decimal;
use core::str::FromStr;

let pi = Decimal::from_str("3.1415926535897932384626433832").unwrap();
assert_eq!(pi.round_dp(2).to_string(), "3.14");

pub fn round_sf(&self, digits: u32) -> Option<Decimal>

Returns Some(Decimal) number rounded to the specified number of significant digits. If the resulting number is unable to be represented by the Decimal number then None will be returned.
When the number of significant figures of the Decimal being rounded is greater than the requested number of significant digits then rounding will be performed using MidpointNearestEven strategy.

Arguments

• digits: the number of significant digits to round to.

Remarks

A significant figure is determined using the following rules:

1. Non-zero digits are always significant.
2. Zeros between non-zero digits are always significant.
3. Leading zeros are never significant.
4. Trailing zeros are only significant if the number contains a decimal point.

Example

use rust_decimal::Decimal;
use core::str::FromStr;

let value = Decimal::from_str("305.459").unwrap();
assert_eq!(value.round_sf(0), Some(Decimal::from_str("0").unwrap()));
assert_eq!(value.round_sf(1), Some(Decimal::from_str("300").unwrap()));
assert_eq!(value.round_sf(2), Some(Decimal::from_str("310").unwrap()));
assert_eq!(value.round_sf(3), Some(Decimal::from_str("305").unwrap()));
assert_eq!(value.round_sf(4), Some(Decimal::from_str("305.5").unwrap()));
assert_eq!(value.round_sf(5), Some(Decimal::from_str("305.46").unwrap()));
assert_eq!(value.round_sf(6), Some(Decimal::from_str("305.459").unwrap()));
assert_eq!(value.round_sf(7), Some(Decimal::from_str("305.4590").unwrap()));
assert_eq!(Decimal::MAX.round_sf(1), None);

pub fn round_sf_with_strategy(
    &self,
    digits: u32,
    strategy: RoundingStrategy
) -> Option<Decimal>

Returns Some(Decimal) number rounded to the specified number of significant digits. If the resulting number is unable to be represented by the Decimal number then None will be returned.
When the number of significant figures of the Decimal being rounded is greater than the requested number of significant digits then rounding will be performed using the provided RoundingStrategy.

Arguments

• digits: the number of significant digits to round to.
• strategy: if required, the rounding strategy to use.

Remarks

A significant figure is determined using the following rules:

1. Non-zero digits are always significant.
2. Zeros between non-zero digits are always significant.
3. Leading zeros are never significant.
4. Trailing zeros are only significant if the number contains a decimal point.

Example

use rust_decimal::{Decimal, RoundingStrategy};
use core::str::FromStr;

let value = Decimal::from_str("305.459").unwrap();
assert_eq!(value.round_sf_with_strategy(0, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("0").unwrap());
assert_eq!(value.round_sf_with_strategy(1, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("300").unwrap());
assert_eq!(value.round_sf_with_strategy(2, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("300").unwrap());
assert_eq!(value.round_sf_with_strategy(3, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("305").unwrap());
assert_eq!(value.round_sf_with_strategy(4, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("305.4").unwrap());
assert_eq!(value.round_sf_with_strategy(5, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("305.45").unwrap());
assert_eq!(value.round_sf_with_strategy(6, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("305.459").unwrap());
assert_eq!(value.round_sf_with_strategy(7, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("305.4590").unwrap());
assert_eq!(Decimal::MAX.round_sf_with_strategy(1, RoundingStrategy::ToZero).unwrap(), Decimal::from_str("70000000000000000000000000000").unwrap());

pub const fn unpack(&self) -> UnpackedDecimal

Convert Decimal to an internal representation of the underlying struct. This is useful for debugging the internal state of the object.

Important Disclaimer

This is primarily intended for library maintainers. The internal representation of a Decimal is considered “unstable” for public use.

Example

use rust_decimal::Decimal;
use core::str::FromStr;

let pi = Decimal::from_str("3.1415926535897932384626433832").unwrap();
assert_eq!(format!("{:?}", pi), "3.1415926535897932384626433832");
assert_eq!(format!("{:?}", pi.unpack()), "UnpackedDecimal { \
    negative: false, scale: 28, hi: 1703060790, mid: 185874565, lo: 1102470952 \
}");

pub fn checked_add(self, other: Decimal) -> Option<Decimal>

Checked addition. Computes self + other, returning None if overflow occurred.

pub fn checked_sub(self, other: Decimal) -> Option<Decimal>

Checked subtraction. Computes self - other, returning None if overflow occurred.

pub fn checked_mul(self, other: Decimal) -> Option<Decimal>

Checked multiplication. Computes self * other, returning None if overflow occurred.

pub fn checked_div(self, other: Decimal) -> Option<Decimal>

Checked division. Computes self / other, returning None if other == 0.0 or the division results in overflow.

pub fn checked_rem(self, other: Decimal) -> Option<Decimal>

Checked remainder. Computes self % other, returning None if other == 0.0.

pub fn from_str_radix(str: &str, radix: u32) -> Result<Decimal, Error>

Trait Implementations

impl<'a> Add<&'a Decimal> for Decimal

type Output = Decimal

The resulting type after applying the + operator.

pub fn add(self, other: &Decimal) -> Decimal

Performs the + operation.

impl<'a, 'b> Add<&'b Decimal> for &'a Decimal

type Output = Decimal

The resulting type after applying the + operator.

pub fn add(self, other: &Decimal) -> Decimal

Performs the + operation.

impl<'a> Add<Decimal> for &'a Decimal

type Output = Decimal

The resulting type after applying the + operator.

pub fn add(self, other: Decimal) -> Decimal

Performs the + operation.

impl Add<Decimal> for Decimal

type Output = Decimal

The resulting type after applying the + operator.

pub fn add(self, other: Decimal) -> Decimal

Performs the + operation.

impl<'a> AddAssign<&'a Decimal> for Decimal

pub fn add_assign(&mut self, other: &'a Decimal)

Performs the += operation.

impl<'a> AddAssign<&'a Decimal> for &'a mut Decimal

pub fn add_assign(&mut self, other: &'a Decimal)

Performs the += operation.

impl AddAssign<Decimal> for Decimal

pub fn add_assign(&mut self, other: Decimal)

Performs the += operation.

impl<'a> AddAssign<Decimal> for &'a mut Decimal

pub fn add_assign(&mut self, other: Decimal)

Performs the += operation.

impl CheckedAdd for Decimal

pub fn checked_add(&self, v: &Decimal) -> Option<Decimal>

Adds two numbers, checking for overflow. If overflow happens, None is returned.

impl CheckedDiv for Decimal

pub fn checked_div(&self, v: &Decimal) -> Option<Decimal>

Divides two numbers, checking for underflow, overflow and division by zero. If any of that happens, None is returned.

impl CheckedMul for Decimal

pub fn checked_mul(&self, v: &Decimal) -> Option<Decimal>

Multiplies two numbers, checking for underflow or overflow. If underflow or overflow happens, None is returned.

impl CheckedRem for Decimal

pub fn checked_rem(&self, v: &Decimal) -> Option<Decimal>

Finds the remainder of dividing two numbers, checking for underflow, overflow and division by zero. If any of that happens, None is returned.

impl CheckedSub for Decimal

pub fn checked_sub(&self, v: &Decimal) -> Option<Decimal>

Subtracts two numbers, checking for underflow. If underflow happens, None is returned.

impl Clone for Decimal

pub fn clone(&self) -> Decimal

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Decimal

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

Formats the value using the given formatter.

impl<'_> Decode<'_, MySql> for Decimal

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

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

impl<'_> Decode<'_, Postgres> for Decimal

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

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

impl Default for Decimal

pub fn default() -> Decimal

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Decimal

pub fn deserialize<D>(
    deserializer: D
) -> Result<Decimal, <D as Deserializer<'de>>::Error> where
    D: Deserializer<'de>, 

Deserialize this value from the given Serde deserializer.

impl Display for Decimal

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

Formats the value using the given formatter.

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

type Output = Decimal

The resulting type after applying the / operator.

pub fn div(self, other: &Decimal) -> Decimal

Performs the / operation.

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

type Output = Decimal

The resulting type after applying the / operator.

pub fn div(self, other: &Decimal) -> Decimal

Performs the / operation.

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

type Output = Decimal

The resulting type after applying the / operator.

pub fn div(self, other: Decimal) -> Decimal

Performs the / operation.

impl Div<Decimal> for Decimal

type Output = Decimal

The resulting type after applying the / operator.

pub fn div(self, other: Decimal) -> Decimal

Performs the / operation.

impl<'a> DivAssign<&'a Decimal> for &'a mut Decimal

pub fn div_assign(&mut self, other: &'a Decimal)

Performs the /= operation.

impl<'a> DivAssign<&'a Decimal> for Decimal

pub fn div_assign(&mut self, other: &'a Decimal)

Performs the /= operation.

impl<'a> DivAssign<Decimal> for &'a mut Decimal

pub fn div_assign(&mut self, other: Decimal)

Performs the /= operation.

impl DivAssign<Decimal> for Decimal

pub fn div_assign(&mut self, other: Decimal)

Performs the /= operation.

impl<'_> Encode<'_, MySql> for Decimal

pub fn encode_by_ref(&self, buf: &mut Vec<u8, Global>) -> IsNull

Writes the value of self into buf without moving self.

fn encode(self, buf: &mut <DB as HasArguments<'q>>::ArgumentBuffer) -> IsNull

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 Decimal

Panics

If this Decimal cannot be represented by PgNumeric.

pub fn encode_by_ref(&self, buf: &mut PgArgumentBuffer) -> IsNull

Writes the value of self into buf without moving self.

fn encode(self, buf: &mut <DB as HasArguments<'q>>::ArgumentBuffer) -> IsNull

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 From<Decimal> for Value

pub fn from(x: Decimal) -> Value

Performs the conversion.

impl From<i128> for Decimal

pub fn from(t: i128) -> Decimal

Performs the conversion.

impl From<i16> for Decimal

pub fn from(t: i16) -> Decimal

Performs the conversion.

impl From<i32> for Decimal

pub fn from(t: i32) -> Decimal

Performs the conversion.

impl From<i64> for Decimal

pub fn from(t: i64) -> Decimal

Performs the conversion.

impl From<i8> for Decimal

pub fn from(t: i8) -> Decimal

Performs the conversion.

impl From<isize> for Decimal

pub fn from(t: isize) -> Decimal

Performs the conversion.

impl From<u128> for Decimal

pub fn from(t: u128) -> Decimal

Performs the conversion.

impl From<u16> for Decimal

pub fn from(t: u16) -> Decimal

Performs the conversion.

impl From<u32> for Decimal

pub fn from(t: u32) -> Decimal

Performs the conversion.

impl From<u64> for Decimal

pub fn from(t: u64) -> Decimal

Performs the conversion.

impl From<u8> for Decimal

pub fn from(t: u8) -> Decimal

Performs the conversion.

impl From<usize> for Decimal

pub fn from(t: usize) -> Decimal

Performs the conversion.

impl FromPrimitive for Decimal

pub fn from_i32(n: i32) -> Option<Decimal>

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

pub fn from_i64(n: i64) -> Option<Decimal>

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

pub fn from_i128(n: i128) -> Option<Decimal>

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

pub fn from_u32(n: u32) -> Option<Decimal>

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

pub fn from_u64(n: u64) -> Option<Decimal>

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

pub fn from_u128(n: u128) -> Option<Decimal>

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

pub fn from_f32(n: f32) -> Option<Decimal>

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

pub fn from_f64(n: f64) -> Option<Decimal>

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_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.

impl FromStr for Decimal

type Err = Error

The associated error which can be returned from parsing.

pub fn from_str(value: &str) -> Result<Decimal, <Decimal as FromStr>::Err>

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

impl Hash for Decimal

pub 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, 

Feeds a slice of this type into the given Hasher.

impl LowerExp for Decimal

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

Formats the value using the given formatter.

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

type Output = Decimal

The resulting type after applying the * operator.

pub fn mul(self, other: &Decimal) -> Decimal

Performs the * operation.

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

type Output = Decimal

The resulting type after applying the * operator.

pub fn mul(self, other: &Decimal) -> Decimal

Performs the * operation.

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

type Output = Decimal

The resulting type after applying the * operator.

pub fn mul(self, other: Decimal) -> Decimal

Performs the * operation.

impl Mul<Decimal> for Decimal

type Output = Decimal

The resulting type after applying the * operator.

pub fn mul(self, other: Decimal) -> Decimal

Performs the * operation.

impl<'a> MulAssign<&'a Decimal> for &'a mut Decimal

pub fn mul_assign(&mut self, other: &'a Decimal)

Performs the *= operation.

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

pub fn mul_assign(&mut self, other: &'a Decimal)

Performs the *= operation.

impl<'a> MulAssign<Decimal> for &'a mut Decimal

pub fn mul_assign(&mut self, other: Decimal)

Performs the *= operation.

impl MulAssign<Decimal> for Decimal

pub fn mul_assign(&mut self, other: Decimal)

Performs the *= operation.

impl Neg for Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn neg(self) -> Decimal

Performs the unary - operation.

impl<'a> Neg for &'a Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn neg(self) -> Decimal

Performs the unary - operation.

impl Nullable for Decimal

pub fn null() -> Value

impl Num for Decimal

type FromStrRadixErr = Error

pub fn from_str_radix(
    str: &str,
    radix: u32
) -> Result<Decimal, <Decimal as Num>::FromStrRadixErr>

Convert from a string and radix (typically 2..=36).

impl One for Decimal

pub fn one() -> Decimal

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<Self>, 

Returns true if self is equal to the multiplicative identity.

impl Ord for Decimal

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

This method returns an Ordering between self and other.

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

Compares and returns the maximum of two values.

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

Compares and returns the minimum of two values.

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

Restrict a value to a certain interval.

impl PartialEq<Decimal> for Decimal

pub fn eq(&self, other: &Decimal) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl PartialOrd<Decimal> for Decimal

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

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

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

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

type Output = Decimal

The resulting type after applying the % operator.

pub fn rem(self, other: &Decimal) -> Decimal

Performs the % operation.

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

type Output = Decimal

The resulting type after applying the % operator.

pub fn rem(self, other: &Decimal) -> Decimal

Performs the % operation.

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

type Output = Decimal

The resulting type after applying the % operator.

pub fn rem(self, other: Decimal) -> Decimal

Performs the % operation.

impl Rem<Decimal> for Decimal

type Output = Decimal

The resulting type after applying the % operator.

pub fn rem(self, other: Decimal) -> Decimal

Performs the % operation.

impl<'a> RemAssign<&'a Decimal> for &'a mut Decimal

pub fn rem_assign(&mut self, other: &'a Decimal)

Performs the %= operation.

impl<'a> RemAssign<&'a Decimal> for Decimal

pub fn rem_assign(&mut self, other: &'a Decimal)

Performs the %= operation.

impl<'a> RemAssign<Decimal> for &'a mut Decimal

pub fn rem_assign(&mut self, other: Decimal)

Performs the %= operation.

impl RemAssign<Decimal> for Decimal

pub fn rem_assign(&mut self, other: Decimal)

Performs the %= operation.

impl Serialize for Decimal

pub 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 Decimal

pub fn abs(&self) -> Decimal

Computes the absolute value.

pub fn abs_sub(&self, other: &Decimal) -> Decimal

The positive difference of two numbers.

pub fn signum(&self) -> Decimal

Returns the sign of the number.

pub fn is_positive(&self) -> bool

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

pub fn is_negative(&self) -> bool

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

impl<'a> Sub<&'a Decimal> for Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn sub(self, other: &Decimal) -> Decimal

Performs the - operation.

impl<'a, 'b> Sub<&'b Decimal> for &'a Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn sub(self, other: &Decimal) -> Decimal

Performs the - operation.

impl<'a> Sub<Decimal> for &'a Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn sub(self, other: Decimal) -> Decimal

Performs the - operation.

impl Sub<Decimal> for Decimal

type Output = Decimal

The resulting type after applying the - operator.

pub fn sub(self, other: Decimal) -> Decimal

Performs the - operation.

impl<'a> SubAssign<&'a Decimal> for Decimal

pub fn sub_assign(&mut self, other: &'a Decimal)

Performs the -= operation.

impl<'a> SubAssign<&'a Decimal> for &'a mut Decimal

pub fn sub_assign(&mut self, other: &'a Decimal)

Performs the -= operation.

impl SubAssign<Decimal> for Decimal

pub fn sub_assign(&mut self, other: Decimal)

Performs the -= operation.

impl<'a> SubAssign<Decimal> for &'a mut Decimal

pub fn sub_assign(&mut self, other: Decimal)

Performs the -= operation.

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

pub fn sum<I>(iter: I) -> Decimal where
    I: Iterator<Item = &'a Decimal>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Sum<Decimal> for Decimal

pub fn sum<I>(iter: I) -> Decimal where
    I: Iterator<Item = Decimal>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl ToPrimitive for Decimal

pub 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.

pub 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.

pub 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.

pub 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.

pub 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 Decimal

type Error = Box<dyn Error + Send + Sync + 'static, Global>

The type returned in the event of a conversion error.

pub fn try_from(
    numeric: PgNumeric
) -> Result<Decimal, Box<dyn Error + Send + Sync + 'static, Global>>

Performs the conversion.

impl TryFrom<f32> for Decimal

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(value: f32) -> Result<Decimal, Error>

Performs the conversion.

impl TryFrom<f64> for Decimal

type Error = Error

The type returned in the event of a conversion error.

pub fn try_from(value: f64) -> Result<Decimal, Error>

Performs the conversion.

impl TryGetable for Decimal

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

impl Type<MySql> for Decimal

pub fn type_info() -> MySqlTypeInfo

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 Type<Postgres> for Decimal

pub 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 Decimal

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

Formats the value using the given formatter.

impl ValueType for Decimal

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

pub fn type_name() -> String

fn unwrap(v: Value) -> Self

impl Zero for Decimal

pub fn zero() -> Decimal

Returns the additive identity element of Self, 0.

pub 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 Copy for Decimal

impl Eq for Decimal