Struct Decimal 

pub struct Decimal { /* private fields */ }

An internal data structure representing a decimal value with fixed precision and scale.

This data structure is immutable and stores decimal values in a compact representation (as a long value) if values are small enough (precision ≤ 18).

Matches Java’s org.apache.fluss.row.Decimal class.

Implementations

impl Decimal

pub fn precision(&self) -> u32

Returns the precision of this Decimal.

The precision is the number of digits in the unscaled value.

pub fn scale(&self) -> u32

Returns the scale of this Decimal.

pub fn is_compact(&self) -> bool

Returns whether the decimal value is small enough to be stored in a long.

pub fn is_compact_precision(precision: u32) -> bool

Returns whether a given precision can be stored compactly.

pub fn to_big_decimal(&self) -> BigDecimal

Converts this Decimal into a BigDecimal.

pub fn to_unscaled_long(&self) -> Result<i64>

Returns a long describing the unscaled value of this Decimal.

pub fn to_unscaled_bytes(&self) -> Vec<u8>

Returns a byte array describing the unscaled value of this Decimal.

pub fn from_arrow_decimal128( i128_val: i128, arrow_scale: i64, precision: u32, scale: u32, ) -> Result<Self>

Creates a Decimal from Arrow’s Decimal128 representation.

pub fn from_big_decimal( bd: BigDecimal, precision: u32, scale: u32, ) -> Result<Self>

Creates an instance of Decimal from a BigDecimal with the given precision and scale.

The returned decimal value may be rounded to have the desired scale. The precision will be checked. If the precision overflows, an error is returned.

pub fn from_unscaled_long( unscaled_long: i64, precision: u32, scale: u32, ) -> Result<Self>

Creates an instance of Decimal from an unscaled long value with the given precision and scale.

pub fn from_unscaled_bytes( unscaled_bytes: &[u8], precision: u32, scale: u32, ) -> Result<Self>

Creates an instance of Decimal from an unscaled byte array with the given precision and scale.

pub fn compute_precision(unscaled: &BigInt) -> usize

Computes the precision of a decimal’s unscaled value, matching Java’s BigDecimal.precision().

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

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

Formats the value using the given formatter.

impl<'a> From<Decimal> for Datum<'a>

fn from(d: Decimal) -> Datum<'a>

Converts to this type from the input 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 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 Serialize for Decimal

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&Datum<'_>> for Decimal

type Error = ()

The type returned in the event of a conversion error.

fn try_from(from: &Datum<'_>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Decimal