rpn-reckoner 0.1.3

A Reverse Polish Notation library
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
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93

# [RPN-Reckoner](https://crates.io/crates/rpn-reckoner/)
DATE: Feb. 8th, 2023

This package provides a Rust library and <br>
an executable for doing Reverse Polish Notation (: RPN) calculations.

## Library

This package's library allows for evaluating RPN expressions <br>
by using the function `rpn_reckoner::eval(expression: String) -> Result<f64, String>`. <br>
This function takes an RPN expression as a string argument and returns a result, <br>
either the evaluated value as a float or an error message as a string.

## Installation

```
cargo add rpn_reckoner
```

### Example1

```rust
extern crate rpn_reckoner;


fn main() {
    let expression = String::from("3 2 +");
    let solution = rpn_reckoner::eval(expression).unwrap();
    println!("{}", solution); // -> 5
}
```

### Example2
```rust
extern crate rpn_reckoner;


fn main() {
    let expression = String::from("6 4 ! +");
    let solution = rpn_reckoner::eval(expression).unwrap();
    println!("{}", solution); // -> 30
}
```

## Read-Eval-Print Loop (: REPL)
```bash
git clone https://github.com/Rei-Ashine/rpn-reckoner.git
```

To start the REPL for evaluating RPN expressions, <br>
the command `cargo run` should be run in the terminal.

![REPL](./PNG/RPN-Reckoner_REPL.png)

## Directory Structure
```
.
├── README.md
├── Cargo.toml
├── LICENSE
└── src
    ├── lib.rs
    ├── main.rs
    ├── operation.rs
    └── test.rs
```
---
```
===============================================================================
 Language            Files        Lines         Code     Comments       Blanks
===============================================================================
 TOML                    1           20           17            0            3
-------------------------------------------------------------------------------
 Markdown                1           46            0           29           17
 |- Rust                 1           16           12            0            4
 (Total)                             62           12           29           21
-------------------------------------------------------------------------------
 Rust                    4          145          105            8           32
 |- Markdown             1           27            0           27            0
 (Total)                            172          105           35           32
===============================================================================
 Total                   6          211          122           37           52
===============================================================================
```

## Reference
- [『高効率言語 Rust 書きかた・作りかた』](https://www.socym.co.jp/book/1351)

![ref1](https://www.socym.co.jp/wp-content/uploads/2022/120Px_syoei-1.jpg)

## License

- [MIT](https://github.com/Rei-Ashine/rpn-reckoner/blob/main/LICENSE)