#calculator #math-expression

taz

Taz is Rust library to evaluate a mathematical expression

2 releases (1 stable)

1.0.0 Aug 15, 2024
0.1.0 Feb 2, 2023

#231 in Math


Used in tazui

Custom license

99KB
2.5K SLoC

Taz

Taz is Rust library to evaluate a mathematical expression.

For example we can evaluate the following expression:

  • 1 + 1
  • 2.0 * (4.43 - 5.99) / 3.0
  • sqrt(x^2 + y^2)
  • cos(pi / 4.0)^2 + sin(pi / 4.0)^2

Build

Build of Taz is made by Rust tool Cargo

To build Taz, you can use the following command:

*cargo build* to compile in debug mode
*cargo build --release* to compile in release mode

To launch Taz units tests, you can use the following command:

*cargo test* to launch tests in debug mode
*cargo test --release* to launch tests in release mode

Code Documentation

Taz code documentation is made also by Cargo with the following command:

*cargo doc* to generate the documentation
*cargo doc --open* to open the documention in your browser

Documentation

The evaluation begin by a tokenization. This step transform a string representing the expression to list of tokens which correspond to infix expression

Then, we convert this infix expression into postfix expression. Indeed an evaluation of postfix expression is easier.

Finally we evaluate the posfix expression by stack method.

In this expression we can use following predefined constant:

  • pi: The constant pi
  • e: The exponential constant
  • c: The speed of light constant

If you want add a new constant, you must go into src/constants.rs file and add it like other constants.

You can also use following predefined functions:

  • abs: the absolute value
  • sqrt: the square root
  • cbrt: the cubic root
  • exp: the exponential
  • ln: the natural logarithm
  • log10: the logarithm with base 10
  • log2: the logarithm with base 2
  • sin: the sinus
  • cos: the cosinus
  • tan: the tangent
  • asin: the arc sinus
  • acos: the arc cosinus
  • atan: the arc tangent
  • sinh: the hyperbolic sinus
  • cosh: the hyperbolic cosinus
  • tanh: the hyperbolic tangent
  • asinh: the hyperbolic arc sinus
  • acosh: the hyperbolic arc cosinus
  • atanh: the hyperbolic arc tangent

If you want add a new predefined function, you must go into src/functions.rs file and add it like other predefined functions.

No runtime deps