mXparser is an open-source mathematical expressions parser/evaluator providing abilities to calculate various expressions at a run time.[1] Expressions definitions are given as plain text, then verified in terms of grammar / syntax, finally calculated. Library source code is maintained separately for Java and C#, providing the same API for Java/JVM, Android, .NET and Mono (Common Language Specification Compliant).
| Original author(s) | Mariusz Gromada |
|---|---|
| Initial release | January 2010 |
| Stable release | 6.1.0
/ 19 October 2024 |
| Repository | github |
| Written in | Java, C#, C++ |
| Platform | JVM, Android, C++, .NET, .NET Core, .NET Standard, Windows Phone, MONO, Xamarin, Xamarin.iOS, Xamarin.Android |
| Website | mathparser |
Main features / usage examples
editmXparser delivers functionalities such as: basic calculations, implied multiplication, built-in constants and functions, numerical calculus operations, iterated operators, user defined constants, user defined functions, user defined recursion, Unicode mathematical symbols support.
mXparser supports basic operators, such as: addition '+', subtraction '-', multiplication '*', division '/', factorial '!', power '^', modulo '#'.
Expression e = new Expression("2+3/(4+5)^4");
double v = e.calculate();
Expression e = new Expression("2(3+4)3");
double v = e.calculate();
Expression e = new Expression("2pi(3+4)2sin(3)e");
double v = e.calculate();
It is possible to combine typical expressions with binary relations (such as: greater than '>', less than '<', equality '=', inequality '<>', greater or equal '>=', lower or equal '<='), as each relation evaluation results in either '1' for true outcome, or '0' for false.
Expression e = new Expression("(2<3)+5");
double v = e.calculate();
Boolean logic also operates assuming equivalence of '1 as true' and '0 as false'. Supported Boolean operators include: AND conjunction, OR disjunction, NAND Sheffer stroke, NOR, XOR Exclusive OR, IMP Implication, CIMP Converse implication, NIMP Material nonimplication, CNIMP Converse nonimplication, EQV Logical biconditional, Negation.
Expression e = new Expression("1 --> 0");
double v = e.calculate();
Supported common mathematical functions (unary, binary and variable number of arguments), including: trigonometric functions, inverse trigonometric functions, logarithm functions, exponential function, hyperbolic functions, Inverse hyperbolic functions, Bell numbers, Lucas numbers, Stirling numbers, prime-counting function, exponential integral function, logarithmic integral function, offset logarithmic integral, binomial coefficient and others.
Expression e = new Expression("sin(0)+ln(2)+log(3,9)");
double v = e.calculate();
Expression e = new Expression("min(1,2,3,4)+gcd(1000,100,10)");
double v = e.calculate();
Expression e = new Expression("if(2<1, 3, 4)");
double v = e.calculate();
Expression e = new Expression("iff(2<1, 1; 3<4, 2; 10<2, 3; 5<10, 4)");
double v = e.calculate();
Built-in mathematical constants, with high precision.
Expression e = new Expression("sin(pi)+ln(e)");
double v = e.calculate();
Iterated summation and product operators.
Expression e = new Expression("sum(i, 1, 10, ln(i))");
double v = e.calculate();
Expression e = new Expression("prod(i, 1, 10, sin(i))");
double v = e.calculate();
Numerical differentiation and integration[2]
editmXparser delivers implementation of the following calculus operations: differentiation and integration.
Expression e = new Expression("der( sin(x), x )");
double v = e.calculate();
Expression e = new Expression("int( sqrt(1-x^2), x, -1, 1)");
double v = e.calculate();
Prime numbers support[2]
editExpression e = new Expression("ispr(21)");
double v = e.calculate();
Expression e = new Expression("Pi(1000)");
double v = e.calculate();
Expression e = new Expression("√2");
double v = e.calculate();
Expression e = new Expression("∜16 + ∛27 + √16");
double v = e.calculate();
Expression e = new Expression("∑(i, 1, 5, i^2)");
double v = e.calculate();
Elements defined by user
editLibrary provides API for creation of user-defined objects, such as: constants, arguments, functions.
Constant t = new Constant("t = 2*pi");
Expression e = new Expression("sin(t)", t);
double v = e.calculate();
Argument x = new Argument("x = 5");
Argument y = new Argument("y = 2*x", x);
Expression e = new Expression("sin(x)+y", x, y);
double v = e.calculate();
Function f = new Function("f(x, y) = sin(x)+cos(y)");
Expression e = new Expression("f(1,2)", f);
double v = e.calculate();
Function f = new Function("f(...) = sum( i, 1, [npar], par(i) )");
Expression e = new Expression("f(1,2,3,4)", f);
double v = e.calculate();
Function fib = new Function("fib(n) = iff( n>1, fib(n-1)+fib(n-2); n=1, 1; n=0, 0 ) )");
Expression e = new Expression("fib(10)", fib);
double v = e.calculate();