⚡ ILMath

ILMath is a hyper-fast and flexible math expression parser for C# and .NET.

Features

⚡ Compiles math expressions to IL code!
🔃 Compiled expressions can be reused many times!
📦 Supports many math functions and constants (including custom)!
🔥 Extremely fast (after compilation)!
📚 Easy to use!

Installation

ILMath is available as a NuGet package.

Usage

using ILMath;

// Create a new evaluation context
var context = EvaluationContext.CreateDefault();

// Register a custom function
context.RegisterFunction("myFunction", parameters => parameters[0] + parameters[1]);

// Register a custom variable
context.RegisterVariable("myVariable", 5);

// Create a new evaluator with name "MyFunction" and expression "myFunction(2, myVariable) * 3"
var evaluator = MathEvaluation.CompileExpression("MyFunction", "myFunction(2, myVariable) * 3");

// Evaluate the expression
var result = evaluator.Invoke(context); // 21

Operators

ILMath supports the following operators.

Operator	Description
`+`	Addition
`-`	Subtraction
`*`	Multiplication
`/`	Division
`%`	Modulo
`^`	Exponentiation

Built-ins

ILMath supports many built-in variables and functions. The following table lists all built-in variables and functions.

Variables

Variable	Description
`pi`	The ratio of a circle's circumference to its diameter
`e`	Euler's number
`tau`	The ratio of a circle's circumference to its radius
`phi`	The golden ratio
`inf`	Infinity
`nan`	Not a number
`degToRad`	Conversion factor from degrees to radians
`radToDeg`	Conversion factor from radians to degrees

Functions

Function	Description
`sin(x)`	Sine of `x` in radians
`cos(x)`	Cosine of `x` in radians
`tan(x)`	Tangent of `x` in radians
`asin(x)`	Arcsine of `x` in radians
`acos(x)`	Arccosine of `x` in radians
`atan(x)`	Arctangent of `x` in radians
`atan2(y, x)`	Arctangent of `y / x` in radians
`sinh(x)`	Hyperbolic sine of `x` in radians
`cosh(x)`	Hyperbolic cosine of `x` in radians
`tanh(x)`	Hyperbolic tangent of `x` in radians
`sqrt(x)`	Square root of `x`
`cbrt(x)`	Cube root of `x`
`root(x, n)`	`n`th root of `x`
`exp(x)`	Exponential function of `x`
`abs(x)`	Absolute value of `x`
`log(x)`	Natural logarithm of `x`
`log10(x)`	Base-10 logarithm of `x`
`log2(x)`	Base-2 logarithm of `x`
`logn(x, n)`	Base-`n` logarithm of `x`
`pow(x, y)`	`x` raised to the power of `y`
`mod(x, y)`	`x` modulo `y`
`min(x, y)`	Minimum of `x` and `y`
`max(x, y)`	Maximum of `x` and `y`
`floor(x)`	Floor of `x`
`ceil(x)`	Ceiling of `x`
`round(x)`	Round of `x`
`sign(x)`	Sign of `x`
`clamp(x, min, max)`	Clamps `x` between `min` and `max`
`lerp(x, y, t)`	Linear interpolation between `x` and `y` by `t`
`inverseLerp(x, y, t)`	Inverse linear interpolation between `x` and `y` by `t`

License

This project is licensed under the MIT License - see the LICENSE file for details.

Reimnop/ILMath