Struct Hyperoperation

pub struct Hyperoperation<Num: NumForKnuth> {
    pub num_a: Num,
    pub num_b: Num,
    pub arrows: u8,
}

Representation of Hyperoperation

Features

• Evaluate the operation with evaluate
• Format it with the Knuth’s up-arrow notation

Example

Evaluating hyperoperation and formatting it with Knuth’s up-arrow notation:

let expr = Hyperoperation::<u64>::new(3, 3, 2); // Represents 3 ↑↑ 3
let result = expr.clone().evaluate(); // Calculate the value of 3 ↑↑ 3

println!("{expr} = {result}");
assert_eq!(result, 7625597484987);
assert_eq!(format!("{expr}"), "3 ↑↑ 3");

Fields

num_a: Num

The first number, before the arrows in Knuth’s up-arrow notation

num_b: Num

The second numer, after the arrows in Knuth’s up-arrow notation

arrows: u8

Number of arrows in Knuth’s up-arrow notation

Implementations

impl<Num: NumForKnuth> Hyperoperation<Num>

pub fn evaluate(self) -> Num

Calculates the value of the operation.

Please keep in mind, that for some expressions (like 3 ↑↑↑ 3), this could take a lot of time and/or overflow the value.
To correctly handle large results, it’s recommended to use BigUint as Num.

Panics

In debug mode, the result might overflow Num’s capacity. In release mode, it might silently overflow!

Example

let expr = Hyperoperation::<u64>::new(3, 3, 2); // Represents 3 ↑↑ 3
assert_eq!(expr.evaluate(), 7625597484987);

pub fn new(num_a: Num, num_b: Num, arrows: u8) -> Self

Shorthand for initializing the struct

Trait Implementations

impl<Num: Clone + NumForKnuth> Clone for Hyperoperation<Num>

fn clone(&self) -> Hyperoperation<Num>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<Num: Display + NumForKnuth> Display for Hyperoperation<Num>

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

Format the expression as Knuth’s notation

Example

assert_eq!(
    format!("{}", Hyperoperation::<u32> {num_a: 3, num_b: 4, arrows: 2}),
    String::from("3 ↑↑ 4")
)