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 const MAX_PRECISION: u8 = arrow_schema::DECIMAL64_MAX_PRECISION

Maximum number of significant digits (18 for 8-byte decimals)

impl VariantDecimal8

pub fn try_new(integer: i64, 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) -> i64

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<i64>

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

Examples

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

Trait Implementations

impl Clone for VariantDecimal8

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 VariantDecimal8

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 VariantDecimal16

fn from(decimal: VariantDecimal8) -> 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 PartialEq for VariantDecimal8

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for VariantDecimal8

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

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: i64

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

type Native = i64

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

fn try_new(integer: i64, 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: i64, scale: i8, ) -> Result<Self, ArrowError>

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

fn integer(&self) -> i64

Returns the unscaled integer value

fn scale(&self) -> u8

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

fn as_integer(&self) -> Option<i64>

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.