Struct VariantDecimal16

pub struct VariantDecimal16 {
    integer: i128,
    scale: u8,
}

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

This struct stores a decimal number using a 128-bit signed integer for the coefficient and an 8-bit unsigned integer for the scale (number of decimal places). Its precision is between 19 and 38 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 VariantDecimal16

// Create a value representing the decimal 12345678901234567.890
let decimal = VariantDecimal16::try_new(12345678901234567890, 3).unwrap();

Fields

integer: i128

scale: u8

Implementations

impl VariantDecimal16

const MAX_PRECISION: u8 = 38u8

const MAX_UNSCALED_VALUE: u128 = 99_999_999_999_999_999_999_999_999_999_999_999_999u128

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

pub fn integer(&self) -> i128

Returns the underlying value of the decimal.

For example, if the decimal is 12345678901234567.890, this will return 12345678901234567890.

pub fn scale(&self) -> u8

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

For example, if the decimal is 12345678901234567.890, this will return 3.

Trait Implementations

impl Clone for VariantDecimal16

fn clone(&self) -> VariantDecimal16

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VariantDecimal16

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

Formats the value using the given formatter.

impl Display for VariantDecimal16

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

Formats the value using the given formatter.

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

fn from(value: VariantDecimal16) -> Self

Converts to this type from the input type.

impl From<VariantDecimal4> for VariantDecimal16

fn from(decimal: VariantDecimal4) -> 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 VariantDecimal16

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

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<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<i128> for VariantDecimal16

type Error = ArrowError

The type returned in the event of a conversion error.

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

Performs the conversion.

impl Copy for VariantDecimal16

impl StructuralPartialEq for VariantDecimal16