Struct TritsChunk 

pub struct TritsChunk(/* private fields */);

A struct to store 5 ternary digits (~7.8 bits) value into one byte.

TritsChunks helps store ternary numbers into a compact memory structure.

From 0 to ± 121.

Implementations

impl TritsChunk

pub fn from_dec(from: i8) -> Self

Creates a TritsChunk from a given decimal value.

Arguments

• from - An i8 value representing the decimal value to be converted into a TritsChunk.

Panics

This function panics if the input value is out of the valid range -121..=121.

Example

use balanced_ternary::TritsChunk;

let chunk = TritsChunk::from_dec(42);
assert_eq!(chunk.to_dec(), 42);

pub fn to_dec(&self) -> i8

Converts the TritsChunk into its decimal representation.

Returns

An i8 value representing the decimal form of the TritsChunk.

Example

use balanced_ternary::TritsChunk;

let chunk = TritsChunk::from_dec(42);
assert_eq!(chunk.to_dec(), 42);

pub fn to_ternary(&self) -> Ternary

Converts the TritsChunk into its ternary representation.

Returns

A Ternary type representing the ternary form of the TritsChunk.

Example

use balanced_ternary::{TritsChunk, Ternary};

let chunk = TritsChunk::from_dec(42);
let ternary = chunk.to_ternary();
assert_eq!(ternary.to_dec(), 42);

pub fn to_fixed_ternary(&self) -> Ternary

Converts the TritsChunk into its fixed-length ternary representation.

Returns

A Ternary type representing the 5-digit fixed-length ternary form of the TritsChunk.

Example

use balanced_ternary::{TritsChunk, Ternary};

let chunk = TritsChunk::from_dec(42);
let fixed_ternary = chunk.to_fixed_ternary();
assert_eq!(fixed_ternary.to_dec(), 42);
assert_eq!(fixed_ternary.to_digit_slice().len(), 5);

pub fn to_digits(&self) -> Vec<Digit>

Converts the TritsChunk into a vector of its individual ternary digits.

Returns

A Vec<Digit> representing the individual ternary digits of the TritsChunk.

The resulting vector will always contain 5 digits since the TritsChunk is represented in a fixed-length ternary form.

Example

use balanced_ternary::{TritsChunk, Digit};

let chunk = TritsChunk::from_dec(42);
let digits: Vec<Digit> = chunk.to_digits();
assert_eq!(digits.len(), 5);

pub fn from_ternary(ternary: Ternary) -> Self

Creates a TritsChunk from a given Ternary value.

Arguments

• ternary - A Ternary value to be converted into a TritsChunk.

Panics

This function panics if the provided ternary value has a logarithmic length greater than 5, indicating that it cannot be represented by a single TritsChunk.

Example

use balanced_ternary::{TritsChunk, Ternary};

let ternary = Ternary::from_dec(42);
let chunk = TritsChunk::from_ternary(ternary);
assert_eq!(chunk.to_dec(), 42);

Trait Implementations

impl Clone for TritsChunk

fn clone(&self) -> TritsChunk

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TritsChunk

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

Formats the value using the given formatter.

impl Default for TritsChunk

fn default() -> TritsChunk

Returns the “default value” for a type.

impl Hash for TritsChunk

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 Ord for TritsChunk

fn cmp(&self, other: &TritsChunk) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for TritsChunk

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

fn partial_cmp(&self, other: &TritsChunk) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for TritsChunk

impl Eq for TritsChunk

impl StructuralPartialEq for TritsChunk