kalker/kalk
2023-07-20 21:08:54 +02:00
..
fuzz Add fuzzer 2021-09-21 23:10:42 +01:00
scripts Added tests for prelude functions 2021-05-25 21:29:59 +02:00
src Configurable max recursion depth 2023-07-20 21:06:55 +02:00
Cargo.toml v2.0.4 2023-07-20 21:08:54 +02:00
LICENSE WebAssembly foundation 2020-12-30 22:50:39 +01:00
README.md Fix typo in kalk readme 2023-01-10 18:35:08 -05:00
wasm-build.sh kalk v2.0.0 2021-05-23 18:43:22 +02:00

kalk

Kalk is a math parser library that supports user-defined variables and functions. An example of what it can parse:

f(x, y) = sum(1, 3, (2sin4/x!)^y) + cos(n deg)
a = 3
f(a, 2)

>> 1.1899401098014355

Features

  • Operators: +, -, *, /, !
  • Groups: (), ⌈⌉, ⌊⌋, []
  • Pre-defined functions and constants
  • User-defined functions and variables. f(x, y) = xy, x = 5
  • Understands fairly ambiguous syntax. Eg. 2sin50 + 2xy
  • Syntax highlighting
  • Special-symbol completion on tab. Eg. write sqrt and press tab. It will be turned into .

Rust Usage

use kalk::parser;
let mut parser_context = parser::Context::new();
let precision = 53;
let result = parser::eval(&mut parser_context, "5*3", precision).unwrap().unwrap();
assert_eq!(result.to_f64(), 15f64);

Using f64 instead of rug::Float

The cargo feature rug enables rug, and is used by default. If you disable this, kalk will use f64 instead, making it more portable.

Compiling

Make sure you have diffutils gcc make and m4 installed.

JavaScript Usage

const kalk = await import("@paddim8/kalk");
const context = new kalk.Context();
console.log(context.evaluate("2pi + 3").toScientificNotation().toString());