Struct BalancedTernaryWord 

pub struct BalancedTernaryWord { /* private fields */ }

64-bit balanced ternary encoding unit

• 61 bits: data payload (39 trits worth of information)
• 3 bits: parity/metadata (2 trits)

Implementations

impl BalancedTernaryWord

pub const MAX_VALUE: i64 = 675_425_858_836_496_044

Maximum value representable in 38 trits (signed balanced) 3^38 = 1,350,851,717,672,992,089 (fits in 61 bits) Range: -(3^38-1)/2 to +(3^38-1)/2

pub const MIN_VALUE: i64 = -675_425_858_836_496_044

pub const DATA_TRITS: usize = 38

Number of trits in the data portion (38 trits = 61 bits)

pub const META_TRITS: usize = 2

Number of trits for metadata/parity (stored in upper 3 bits)

pub fn new(value: i64, metadata: WordMetadata) -> Result<Self, VsaError>

Create a new word from a signed integer value and metadata

pub fn from_raw(packed: u64) -> Self

Create from raw packed representation

pub fn raw(&self) -> u64

Get the raw packed value

pub fn data_bits(&self) -> u64

Extract the data portion (lower 61 bits)

pub fn metadata(&self) -> WordMetadata

Extract metadata

pub fn decode(&self) -> i64

Decode to signed integer value

pub fn compute_parity(&self) -> i8

Compute parity trit for error detection

Trait Implementations

impl Clone for BalancedTernaryWord

fn clone(&self) -> BalancedTernaryWord

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BalancedTernaryWord

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BalancedTernaryWord

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Hash for BalancedTernaryWord

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for BalancedTernaryWord

fn eq(&self, other: &BalancedTernaryWord) -> 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 Serialize for BalancedTernaryWord

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for BalancedTernaryWord

impl Eq for BalancedTernaryWord

impl StructuralPartialEq for BalancedTernaryWord