Byces.Calculator 1.0.0

Byces.Calculator

A simple .NET calculator that solves string math expressions

Usage example

string expression = "2 + 5 * 3";

MathResult mathResult = MathResultBuilder.GetMathResult(expression);
// or
MathResult mathResult = new MathResultBuilder().WithExpression(expression).Build();

if (mathResult.IsValid) // true
{
    Console.WriteLine(mathResult.Result); // 17
}
else
{
    Console.WriteLine(mathResult.ErrorMessage);
}

Public Models

MathResult (readonly struct)

MathResultBuilder (class)

Building expressions

Before showing some syntax examples, here are some observations:

• Numbers, operations and self operations are not case sensitive
• The builder is not sensitive to whitespace and using it has a low impact on performance

// You can use signs to represent negative and positive numbers
string expressionExample1 = "-5 + +5";

// You can use parentheses to set priorities in the expression
string expressionExample2 = "((2 + 5) * 2) * 3";

// You can also represent numbers like this
string expressionExample3 = "1E+3";

// This is an expression with two operations and two self operations
string expressionExample4 = "fact(2 + 3) * fact3";

<hr />

Available operations

Add

string expression1 = "2+4+6";
string expression2 = "2 add 4 add 6";

Subtract

string expression1 = "2-4-6";
string expression2 = "2 sub 4 sub 6";

Multiply

string expression1 = "2*4*6";
string expression2 = "2 mul 4 mul 6";

Divide

string expression1 = "2/4/6";
string expression2 = "2 div 4 div 6";

Power

string expression1 = "2^4^6";
string expression2 = "2 pow 4 pow 6";

Root

string expression1 = "2√4√6";
string expression2 = "2 rt 4 rt 6";

Modulus

string expression1 = "2%4%6";
string expression2 = "2 mod 4 mod 6";

<hr />

Available self operations

Factorial

string expression = "fact(3)";

Square root

string expression1 = "sqrt(3)";
string expression2 = "√3";

Cube root

string expression = "cbrt(3)";

Cosine

string expression = "cos(3)";

Sine

string expression = "sin(3)";

Tangent

string expression = "tan(3)";

Cosine hyperbolic

string expression = "cosh(3)";

Sine hyperbolic

string expression = "sinh(3)";

Tangent hyperbolic

string expression = "tanh(3)";

Radian (360º)

string expression = "rad(3)";

<hr />

Available special numbers

PI

string expression1 = "π";
string expression2 = "pi";

Euler

string expression = "euler";

Feedback and Bugs

Feel free to send suggestions and problems on the Issues tab on Github, thanks to those who read this far! 😄