Struct Ternary

pub struct Ternary { /* private fields */ }

Represents a balanced ternary number using a sequence of Digits.

Provides functions for creating, parsing, converting, and manipulating balanced ternary numbers.

Implementations

impl Ternary

pub fn new(digits: Vec<Digit>) -> Ternary

Creates a new balanced ternary number from a vector of Digits.

pub fn log(&self) -> usize

Returns the number of digits (length) of the balanced ternary number.

pub fn get_digit(&self, index: usize) -> Option<&Digit>

Returns a reference to the Digit indexed by index if it exists.

Digits are indexed from the right:

use balanced_ternary::Ternary;

// Indexes :
//                              32
//                             4||1
//                            5||||0
//                            ||||||
//                            vvvvvv
let ternary = Ternary::parse("+++--+");
assert_eq!(ternary.get_digit(1).unwrap().to_char(), '-')

pub fn parse(str: &str) -> Self

Parses a string representation of a balanced ternary number into a Ternary object.

Each character in the string must be one of +, 0, or -.

pub fn to_dec(&self) -> i64

Converts the Ternary object to its integer (decimal) representation.

Calculates the sum of each digit’s value multiplied by the appropriate power of 3.

pub fn from_dec(dec: i64) -> Self

Creates a balanced ternary number from a decimal integer.

The input number is converted into its balanced ternary representation, with digits represented as Digits.

Trait Implementations

impl Add<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the + operator.

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

Performs the + operation.

impl BitAnd<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the & operator.

fn bitand(self, rhs: &Ternary) -> Self::Output

Performs the & operation.

impl BitOr<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the | operator.

fn bitor(self, rhs: &Ternary) -> Self::Output

Performs the | operation.

impl BitXor<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the ^ operator.

fn bitxor(self, rhs: &Ternary) -> Self::Output

Performs the ^ operation.

impl Clone for Ternary

fn clone(&self) -> Ternary

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Ternary

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

Formats the value using the given formatter.

impl Display for Ternary

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

Formats the value using the given formatter.

impl Div<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the / operator.

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

Performs the / operation.

impl From<Ternary> for Tryte

fn from(value: Ternary) -> Self

Converts to this type from the input type.

impl From<Tryte> for Ternary

fn from(value: Tryte) -> Self

Converts to this type from the input type.

impl Hash for Ternary

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 Mul<&Ternary> for &Ternary

type Output = Ternary

The resulting type after applying the * operator.

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

Performs the * operation.

impl Neg for &Ternary

fn neg(self) -> Self::Output

Returns the negation of the current Ternary object.

Negates each digit in the number.

type Output = Ternary

The resulting type after applying the - operator.

impl PartialEq for Ternary

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

type Output = Ternary

The resulting type after applying the - operator.

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

Performs the - operation.

impl Eq for Ternary

impl StructuralPartialEq for Ternary