Struct Decimal128

pub struct Decimal128 {
    value: i128,
    precision: u8,
    scale: i8,
}

128bit decimal, using the i128 to represent the decimal.

precision: the total number of digits in the number, it’s range is [1, 38].

scale: the number of digits to the right of the decimal point, it’s range is [0, precision].

Fields

value: i128

precision: u8

scale: i8

Implementations

impl Decimal128

pub fn new(value: i128, precision: u8, scale: i8) -> Self

Create a new Decimal128 from i128, precision and scale without any validation.

pub fn try_new(value: i128, precision: u8, scale: i8) -> Result<Self>

Try new Decimal128 from i128, precision and scale with validation.

pub fn val(&self) -> i128

Return underlying value without precision and scale

pub fn precision(&self) -> u8

Returns the precision of this decimal.

pub fn scale(&self) -> i8

Returns the scale of this decimal.

pub fn to_scalar_value(&self) -> (Option<i128>, u8, i8)

Convert to ScalarValue(value,precision,scale)

pub fn split_value(&self) -> (i64, i64)

split the self.value(i128) to (high-64 bit, low-64 bit), and the precision, scale information is discarded.

Return: (high-64 bit, low-64 bit)

pub fn from_value_precision_scale( hi: i64, lo: i64, precision: u8, scale: i8, ) -> Self

Convert from precision, scale, a i128 value which represents by i64 + i64 value(high-64 bit, low-64 bit).

pub fn negative(self) -> Self

Trait Implementations

impl Clone for Decimal128

fn clone(&self) -> Decimal128

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Decimal128

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

Formats the value using the given formatter.

impl Default for Decimal128

The default value of Decimal128 is 0, and its precision is 1 and scale is 0.

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Decimal128

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Decimal128

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

Formats the value using the given formatter.

impl From<Decimal> for Decimal128

Convert from RustDecimal to Decimal128 RustDecimal can represent the range is smaller than Decimal128, it is safe to convert RustDecimal to Decimal128

fn from(rd: RustDecimal) -> Self

Converts to this type from the input type.

impl From<Decimal128> for Value

fn from(decimal: Decimal128) -> Self

Converts to this type from the input type.

impl From<Decimal128> for i128

fn from(decimal: Decimal128) -> Self

Converts to this type from the input type.

impl From<i128> for Decimal128

fn from(value: i128) -> Self

Converts to this type from the input type.

impl FromStr for Decimal128

Convert from string to Decimal128 If the string length is less than 28, the result of rust_decimal will underflow, In this case, use BigDecimal to get accurate result.

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl Hash for Decimal128

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

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 PartialEq for Decimal128

fn eq(&self, other: &Self) -> 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 Decimal128

fn partial_cmp(&self, other: &Self) -> 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 Serialize for Decimal128

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<BigDecimal> for Decimal128

Try from BigDecimal to Decimal128 The range that BigDecimal can represent is larger than Decimal128, so it is not safe to convert BigDecimal to Decimal128, If the BigDecimal is out of range, return error.

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: BigDecimal) -> Result<Self, Self::Error>

Performs the conversion.

impl Copy for Decimal128

impl Eq for Decimal128