hyperoperation 0.1.1

Hyperoperation (sometimes known as Knuth's notation) calculation library for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

 

# Hyperoperation

This crate allows to calculate and format [hyperoperation](https://en.wikipedia.org/wiki/Hyperoperation), sometimes known as **Knuth's up-arrow notation**, which is a way to define very large numbers, such as famous 3↑↑↑3.

### Features

- Calculate value of hyperoperations ([more](hyperoperation) and [more](Hyperoperation::evaluate))
- Format hyperoperations with Knuth's up-arrow notation ([more](struct.Hyperoperation.html#method.fmt))
- Use any unsigned numeric type for calculation fitting [some conditions](NumForKnuth), such as [BigUint](https://docs.rs/num-bigint/latest/num_bigint/struct.BigUint.html)



### Examples

Simple calculation:

```rust
# use hyperoperation::hyperoperation; 
assert_eq!(
    hyperoperation::<u64>(&3, 3, 2), // 3 ↑↑ 3
    7625597484987
);
```



Using [BigUint](https://docs.rs/num-bigint/latest/num_bigint/struct.BigUint.html) to handle big results without overflowing:

```rust
use num_bigint::BigUint;
# use hyperoperation::hyperoperation; 

let result = hyperoperation::<BigUint>(&5u8.into(), 3u8.into(), 2); // 5 ↑↑ 3
println!("Result:\n{result}");
assert_eq!(
    result % BigUint::from(100_000_000u32),
    8203125u32.into()
);
```



Using [Hyperoperation struct ](Hyperoperation)and formatting it with [Knuth's up-arrow notation](https://en.wikipedia.org/wiki/Knuth%27s_up-arrow_notation):

```rust
# use hyperoperation::Hyperoperation;
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");
```