Struct Decimal

pub struct Decimal { /* private fields */ }

MySql decimal.

The only purpose of this type is to parse binary decimal from binlogs, so it isn’t meant to be an alternative to decimal_t.

This type supports:

• serialization/deserialization to/from binary format (see read_bin and write_bin functions);
• parsing from decimal string/buffer (see Decimal::parse_str_bytes, FromStr impl);
• conversion to decimal string (using Display).

Notes

• Ord and Eq impls are relied on the binary representation, i.e. both rhs and lhs will be serialized into temporary buffers;
• even though MySql’s string2decimal function allows scientific notation, this implementation denies it.

Implementations

impl Decimal

pub fn bin_size(&self) -> usize

pub fn parse_bytes(bytes: &[u8]) -> Result<Self, ParseDecimalError>

👎Deprecated: use parse_str_bytes

See Decimal::parse_str_bytes.

pub fn parse_str_bytes(bytes: &[u8]) -> Result<Self, ParseDecimalError>

Runs Decimal::from_str on the given bytes.

pub fn write_bin<T: Write>(&self, output: T) -> Result<()>

pub fn read_packed<T: Read>(input: T, keep_precision: bool) -> Result<Self>

Reads packed representation of a Decimal.

Packed representation is:

1. precision (u8)
2. scale (u8)
3. serialized decimal value (see Decimal::read_bin)

pub fn read_bin<T: Read>( input: T, precision: usize, scale: usize, keep_prec: bool, ) -> Result<Self>

Reads serialized representation of a decimal value.

The value is usually written in the packed form (see Decimal::read_packed).

Trait Implementations

impl Clone for Decimal

fn clone(&self) -> Decimal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Decimal

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

Formats the value using the given formatter.

impl Default for Decimal

fn default() -> Decimal

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

type Err = ParseDecimalError

The associated error which can be returned from parsing.

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

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

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.

impl PartialEq for Decimal

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