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

pub const MAX_PRECISION: u8 = 38u8

Maximum number of significant digits (38 for 16-byte decimals)

impl VariantDecimal16

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

Attempts to create a new instance of this decimal type, failing if the value is too wide or the scale is too large.

pub fn integer(&self) -> i128

Returns the unscaled integer value of the decimal.

For example, if the decimal is 123.45, this will return 12345.

pub fn scale(&self) -> u8

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

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

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<(), Error>

Formats the value using the given formatter.

impl Display for VariantDecimal16

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

Formats the value using the given formatter.

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

fn from(value: VariantDecimal16) -> Variant<'_, '_>

Converts to this type from the input type.

impl From<VariantDecimal4> for VariantDecimal16

fn from(decimal: VariantDecimal4) -> VariantDecimal16

Converts to this type from the input type.

impl From<VariantDecimal8> for VariantDecimal16

fn from(decimal: VariantDecimal8) -> VariantDecimal16

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<VariantDecimal4, 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<VariantDecimal8, 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<VariantDecimal16, ArrowError>

Performs the conversion.

impl VariantDecimalType for VariantDecimal16

const MAX_PRECISION: u8 = 38u8

Maximum number of significant digits this decimal type can represent (9, 18, or 38)

const MAX_UNSCALED_VALUE: i128 = 99_999_999_999_999_999_999_999_999_999_999_999_999i128

The largest positive unscaled value that fits in Self::MAX_PRECISION digits.

type Native = i128

The underlying signed integer type (i32, i64, or i128)

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

Creates a new decimal value from the given unscaled integer and scale, failing if the integer’s width, or the requested scale, exceeds MAX_PRECISION.

fn try_new_with_signed_scale( integer: i128, scale: i8, ) -> Result<VariantDecimal16, ArrowError>

Attempts to convert an unscaled arrow decimal value to the indicated variant decimal type.

fn integer(&self) -> i128

Returns the unscaled integer value

fn scale(&self) -> u8

Returns the scale (number of digits after the decimal point)

fn is_valid_precision_and_scale(precision: &u8, scale: &i8) -> bool

True if the given precision and scale are valid for this variant decimal type.

impl Copy for VariantDecimal16

impl StructuralPartialEq for VariantDecimal16