StringMath 2.1.0

Creating and using a calculator

Calculator myCalculator = new Calculator();
decimal result = myCalculator.Evaluate("1 * (2 - 3) ^ 2"); // 1

// Using custom operators
myCalculator.AddOperator("abs", a => a > 0 ? a : -a);
decimal result = myCalculator.Evaluate("abs -5"); // 5

// Using custom operator precedence (you can specify an int for precedence)
myCalculator.AddOperator("max", (a, b) => a > b ? a : b, Precedence.Power);
decimal result = myCalculator.Evaluate("2 * 3 max 4"); // 8

Creating and using variables

// Creating a variables collection
Replacements variables = new Replacements
{
	["a"] = 5,
	["PI"] = 3.1415926535897931
};

Calculator myCalculator = new Calculator(variables); // default variables collection is optional (can still add variables without a collection)

// Replacing or creating variables
myCalculator.Replace("a", 2);
myCalculator.Replace("b", 1); // new syntax: myCalculator["b"] = 1;
decimal result = myCalculator.Evaluate("{a} + 2 * {b} + {PI}"); // 7.1415926535897931

Creating and reusing operations

myCalculator["a"] = 5;

// Creating operations
OperationInfo op = myCalculator.CreateOperation("2 * {a}");
decimal result1 = myCalculator.Evaluate(op); // 10

// Reusing the operation (improves performance)
myCalculator["a"] = 3;
decimal result2 = myCalculator.Evaluate(op); // 6

Using the static api: SMath

// Same API as a calculator instance except the Evaluate method
decimal result = SMath.Evaluate("1 + 1"); // 2
decimal result = SMath.Evaluate("1 + {myVar}", new Replacements { ["myVar"] = 1 }); // 2

Binary operators

+ (addition)
- (subtraction)
* (multiplication)
/ (division)
% (remainder)
^ (power)
log (logarithm)
max (maximum)
min (minimum)

Unary operators

- (negation)
! (factorial)
sqrt (square root)
sin (sinus)
cos (cosinus)
tan (tangent)
ceil (ceiling)
floor (floor)
round (rounding)
exp (e raised to power)
abs (absolute)