Struct Decimal 

pub struct Decimal(/* private fields */);

An exact decimal number.

Implementations

impl Decimal

pub const ZERO: Decimal

The number zero.

pub const ONE: Decimal

The number one.

pub const MAX_VALUE: Decimal

The largest value: 79,228,162,514,264,337,593,543,950,335.

pub const MIN_VALUE: Decimal

The smallest value: -79,228,162,514,264,337,593,543,950,335.

pub fn from_parts(mantissa: u128, scale: u8, negative: bool) -> Decimal

A decimal of mantissa / 10^scale, negated when negative.

Panics when the mantissa has more than 96 bits or the scale is greater than 28.

pub fn mantissa(&self) -> u128

The 96-bit integer that, divided by 10^scale, is the magnitude.

pub fn scale(&self) -> u8

The number of digits after the decimal point (0 to 28).

pub fn is_sign_negative(&self) -> bool

Whether the sign bit is set. Negative zero has it set and is equal to zero.

pub fn is_zero(&self) -> bool

Whether the value is zero (of any scale and sign).

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

The larger of two values (C# Math.Max): of two equal values the first, which matters for their scales.

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

The smaller of two values (C# Math.Min): of two equal values the second, which matters for their scales.

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

The sum, or None when it is out of range.

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

The difference, or None when it is out of range.

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

The quotient, or None when it is out of range. Panics when other is zero.

pub fn to_f64(&self) -> f64

The nearest double-precision number (the explicit conversion of the managed type to a double).

pub fn to_f32(&self) -> f32

The nearest single-precision number (the explicit conversion of the managed type to a float): the double of the value, narrowed.

pub fn round_to_integer(&self) -> i128

The value rounded to an integer, midpoints to even (Decimal.Round with no decimals, which the conversions of the managed runtime to the integer types apply before their range check).

pub fn from_f64(value: f64) -> Decimal

The decimal of a double-precision number, rounded to 15 significant digits (the explicit conversion of a double to the managed type).

Panics when the number is not finite or is outside the value range.

pub fn from_f32(value: f32) -> Decimal

The decimal of a single-precision number, rounded to 7 significant digits (the explicit conversion of a float to the managed type).

Panics when the number is not finite or is outside the value range.

pub fn try_from_f32(value: f32) -> Option<Decimal>

from_f32, with None where it panics.

pub fn try_from_f64(value: f64) -> Option<Decimal>

from_f64, with None where it panics.

pub fn parse(s: &str) -> Result<Decimal, NumberParseError>

Parses text of the invariant culture with the Number styles: leading and trailing white space, a leading or trailing sign, a decimal point and group separators.

pub fn try_parse(s: &str) -> Option<Decimal>

Decimal::parse without the reason of a failure.

pub fn parse_with( s: &str, styles: NumberStyles, provider: Option<&NumberFormatInfo>, ) -> Result<Decimal, NumberParseError>

Parses text with the given styles and format information (C# decimal.Parse(string, NumberStyles, IFormatProvider)). Without a provider the format information of the current culture is used.

Styles that are not defined, and the hexadecimal and binary styles, are an error (NumberParseError::InvalidStyle).

pub fn try_parse_with( s: &str, styles: NumberStyles, provider: Option<&NumberFormatInfo>, ) -> Option<Decimal>

Decimal::parse_with without the reason of a failure.

pub fn to_string_with( &self, format: &str, provider: Option<&NumberFormatInfo>, ) -> Result<String, FormatError>

Formats the value with a standard or custom numeric format string (C# ToString(string, IFormatProvider)). Without a provider the format information of the current culture is used.

pub fn to_string_provider(&self, provider: &NumberFormatInfo) -> String

Formats the value in the general format with the given format information (C# ToString(IFormatProvider)).

Trait Implementations

impl Add for Decimal

type Output = Decimal

The resulting type after applying the + operator.

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

Performs the + operation.

impl AddAssign for Decimal

fn add_assign(&mut self, other: Decimal)

Performs the += operation.

impl Clone for Decimal

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Decimal

impl Debug for Decimal

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

Formats the value using the given formatter.

impl Default for Decimal

fn default() -> Self

Returns the “default value” for a type.

impl Display for Decimal

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

Formats the value using the given formatter.

impl Div for Decimal

type Output = Decimal

The resulting type after applying the / operator.

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

Performs the / operation.

impl Eq for Decimal

impl From<i8> for Decimal

fn from(value: i8) -> Decimal

Converts to this type from the input type.

impl From<i16> for Decimal

fn from(value: i16) -> Decimal

Converts to this type from the input type.

impl From<i32> for Decimal

fn from(value: i32) -> Decimal

Converts to this type from the input type.

impl From<i64> for Decimal

fn from(value: i64) -> Decimal

Converts to this type from the input type.

impl From<isize> for Decimal

fn from(value: isize) -> Decimal

Converts to this type from the input type.

impl From<u8> for Decimal

fn from(value: u8) -> Decimal

Converts to this type from the input type.

impl From<u16> for Decimal

fn from(value: u16) -> Decimal

Converts to this type from the input type.

impl From<u32> for Decimal

fn from(value: u32) -> Decimal

Converts to this type from the input type.

impl From<u64> for Decimal

fn from(value: u64) -> Decimal

Converts to this type from the input type.

impl From<usize> for Decimal

fn from(value: usize) -> Decimal

Converts to this type from the input type.

impl FromStr for Decimal

type Err = NumberParseError

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 Decimal

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 MarkupTyped for Decimal

const MARKUP: &'static MarkupType

The markup metadata of the type.

impl Neg for Decimal

type Output = Decimal

The resulting type after applying the - operator.

fn neg(self) -> Decimal

Performs the unary - operation.

impl Ord for Decimal

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

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Decimal

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Decimal

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 StructuralPartialEq for Decimal

impl Sub for Decimal

type Output = Decimal

The resulting type after applying the - operator.

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

Performs the - operation.

impl SubAssign for Decimal

fn sub_assign(&mut self, other: Decimal)

Performs the -= operation.