Struct Scalar 

pub struct Scalar { /* private fields */ }

One finite numeric value with an explicit declared representation.

The private bits are validated at construction. Integers never pass through floating point, and binary128 never passes through binary64. PartialEq compares numeric values of matching types, so positive and negative float zero compare equal. Self::bits preserves their distinct representations.

Implementations

impl Scalar

pub fn parse(dtype: DType, text: &str) -> Result<Self, DataError>

Parses decimal text directly at the requested precision.

Float literals are rounded once with ties-to-even; unlike Self::convert, decimal parsing accepts normal representational rounding (for example 0.1). Text may have a sign, decimal point, and decimal exponent for floats.

Errors

Rejects malformed or overlong text, out-of-range integers, and nonfinite floats.

pub fn from_bits(dtype: DType, bits: u128) -> Result<Self, DataError>

Creates a finite value from unsigned representation bits.

Signed integers use two’s complement in exactly dtype.bit_width() bits; high bits must be zero even for negative integers.

Errors

Rejects bits outside the declared width and nonfinite float encodings.

pub fn from_signed(dtype: DType, value: i128) -> Result<Self, DataError>

Creates a signed integer after validating the declared range.

Errors

Rejects non-signed types and values outside their exact integer range.

pub fn from_unsigned(dtype: DType, value: u128) -> Result<Self, DataError>

Creates an unsigned integer after validating the declared range.

Errors

Rejects signed/float types and values outside the exact unsigned range.

pub const fn zero(dtype: DType) -> Self

Positive zero in any supported representation.

pub const fn dtype(self) -> DType

Declared numeric type.

pub const fn bits(self) -> u128

Representation bits with all unused high bits zero.

pub fn as_i128(self) -> Option<i128>

Signed integer value, without converting any other representation.

pub fn as_u128(self) -> Option<u128>

Unsigned integer value, without converting any other representation.

pub fn to_f64(self) -> Result<f64, DataError>

Converts exactly to a native binary64 value for a host boundary.

Errors

Rejects any value not representable exactly in binary64.

pub fn convert(self, dtype: DType) -> Result<Self, DataError>

Converts only when the exact value and signed-zero information survive.

Errors

Rejects out-of-range, fractional, or precision-losing conversions.

pub fn neg(&self) -> Result<Self, DataError>

Negates a value with checked integer overflow.

Errors

Rejects the signed minimum and nonzero unsigned values.

pub fn binary(self, operation: BinaryOp, rhs: Self) -> Result<Self, DataError>

Evaluates one checked operation at the operands’ declared precision.

Floating-point rounding and underflow follow IEEE ties-to-even. Integer overflow and nonfinite floating-point results are errors.

Errors

Rejects mixed types, zero divisors, overflow, and nonfinite results.

pub fn compare(self, rhs: Self) -> Result<Ordering, DataError>

Compares numeric values of identical declared types.

Errors

Returns DataError::TypeMismatch for different declared types.

Trait Implementations

impl Add for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self::Output

Performs the + operation.

impl Clone for Scalar

fn clone(&self) -> Scalar

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Scalar

impl Debug for Scalar

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Scalar

fn deserialize<D: Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Display for Scalar

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

Formats the value using the given formatter.

impl Div for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the / operator.

fn div(self, rhs: Self) -> Self::Output

Performs the / operation.

impl Eq for Scalar

impl Mul for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the * operator.

fn mul(self, rhs: Self) -> Self::Output

Performs the * operation.

impl Neg for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl PartialEq for Scalar

fn eq(&self, rhs: &Self) -> 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 Rem for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the % operator.

fn rem(self, rhs: Self) -> Self::Output

Performs the % operation.

impl Serialize for Scalar

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl Sub for Scalar

type Output = Result<Scalar, DataError>

The resulting type after applying the - operator.

fn sub(self, rhs: Self) -> Self::Output

Performs the - operation.