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 = arrow_schema::DECIMAL128_MAX_PRECISION

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

impl VariantDecimal16

pub fn try_new(integer: i128, scale: u8) -> Result<Self, 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.

pub fn as_integer(&self) -> Option<i128>

Returns Some(i128) if scale is zero or integer of the decimal is divisible by 10^scale, None for other values.

Examples

use parquet_variant::VariantDecimal16;
//Return the integer if scale is 0
let d1 = VariantDecimal16::try_new(123, 0).unwrap();
assert_eq!(d1.as_integer(), Some(123));
// or if the integer is divisible by 10^scale
let d2 = VariantDecimal16::try_new(100, 2).unwrap();
assert_eq!(d2.as_integer(), Some(1));
// or the integer is negative and divisible by 10^scale
let d3 = VariantDecimal16::try_new(-100, 2).unwrap();
assert_eq!(d3.as_integer(), Some(-1));
// or if the integer is 0
let d4 = VariantDecimal16::try_new(0, 4).unwrap();
assert_eq!(d4.as_integer(), Some(0));
// but not if the integer is not divisible by 10^scale
let d5 = VariantDecimal16::try_new(123, 2).unwrap();
assert_eq!(d5.as_integer(), None);
// or the integer is negative and not divisible by 10^scale
let d6 = VariantDecimal16::try_new(-123, 2).unwrap();
assert_eq!(d6.as_integer(), None);

Trait Implementations

impl Clone for VariantDecimal16

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for VariantDecimal16

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<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 From<VariantDecimal16> for Variant<'_, '_>

fn from(value: VariantDecimal16) -> Self

Converts to this type from the input type.

impl PartialEq for VariantDecimal16

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for VariantDecimal16

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

const MAX_PRECISION: u8 = Self::MAX_PRECISION

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

const MAX_UNSCALED_VALUE: i128

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<Self, 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<Self, 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 as_integer(&self) -> Option<i128>

Converts the decimal as an integer if possible,

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.