Struct VariantDecimal8

pub struct VariantDecimal8 {
    integer: i64,
    scale: u8,
}

Represents an 8-byte decimal value in the Variant format.

This struct stores a decimal number using a 64-bit signed integer for the coefficient and an 8-bit unsigned integer for the scale (number of decimal places). Its precision is between 10 and 18 digits.

For valid precision and scale values, see the Variant specification:

https://github.com/apache/parquet-format/blob/87f2c8bf77eefb4c43d0ebaeea1778bd28ac3609/VariantEncoding.md?plain=1#L418-L420

Example: Create a VariantDecimal8

// Create a value representing the decimal 123456.78
let decimal = VariantDecimal8::try_new(12345678, 2).expect("Failed to create decimal");

Fields

integer: i64

scale: u8

Implementations

impl VariantDecimal8

pub(crate) const MAX_PRECISION: u8 = 18u8

pub(crate) const MAX_UNSCALED_VALUE: u64 = 999_999_999_999_999_999u64

pub fn try_new(integer: i64, scale: u8) -> Result<Self, ArrowError>

pub fn integer(&self) -> i64

Returns the underlying value of the decimal.

For example, if the decimal is 123456.78, this will return 12345678.

pub fn scale(&self) -> u8

Returns the scale of the decimal (how many digits after the decimal point).

For example, if the decimal is 123456.78, this will return 2.

Trait Implementations

impl Clone for VariantDecimal8

fn clone(&self) -> VariantDecimal8

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VariantDecimal8

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

Formats the value using the given formatter.

impl Display for VariantDecimal8

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

Formats the value using the given formatter.

impl From<VariantDecimal4> for VariantDecimal8

fn from(decimal: VariantDecimal4) -> Self

Converts to this type from the input type.

impl From<VariantDecimal8> for Variant<'_, '_>

fn from(value: VariantDecimal8) -> Self

Converts to this type from the input type.

impl From<VariantDecimal8> for VariantDecimal16

fn from(decimal: VariantDecimal8) -> Self

Converts to this type from the input type.

impl PartialEq for VariantDecimal8

fn eq(&self, other: &VariantDecimal8) -> 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 TryFrom<VariantDecimal16> for VariantDecimal8

type Error = ArrowError

The type returned in the event of a conversion error.

fn try_from(decimal: VariantDecimal16) -> Result<Self, ArrowError>

Performs the conversion.

impl TryFrom<VariantDecimal8> for VariantDecimal4

type Error = ArrowError

The type returned in the event of a conversion error.

fn try_from(decimal: VariantDecimal8) -> Result<Self, ArrowError>

Performs the conversion.

impl TryFrom<i64> for VariantDecimal8

type Error = ArrowError

The type returned in the event of a conversion error.

fn try_from(integer: i64) -> Result<Self, ArrowError>

Performs the conversion.

impl Copy for VariantDecimal8

impl StructuralPartialEq for VariantDecimal8