Byces.Calculator 3.0.0

Byces.Calculator

A simple .NET calculator that solves string math expressions

Usage example

ICalculator calculator = new CalculatorBuilder().Build();

string expression = "2 + 5 * 3";
var mathResult = calculator.GetDoubleResult(expression);

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

Building expressions

Before showing some syntax examples, here are some observations:

• Numbers, variables, operators and functions are not case sensitive
• The calculator 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 operators and two functions
string expressionExample4 = "fact(2 + 3) * fact3";

// You can also use implicit multiplication
string expressionExample5 = "2(5)";

Available operators

Arithmetic

Logical and Comparison

Special

Available functions

Arithmetic

Logic and Comparison

Trigonometry

Available variables

Number

Boolean

Public Models

MathResult{T} (readonly struct)

CalculatorBuilder (class)

Calculator (class) and ICalculator (interface)

Benchmark (one million iterations)

In the Benchmark below, one million iterations were made for each method

BenchmarkDotNet=v0.13.5, OS=Windows 11 (10.0.22621.2134/22H2/2022Update/SunValley2)
AMD Ryzen 5 3500X, 1 CPU, 6 logical and 6 physical cores
.NET SDK=7.0.400
  [Host]     : .NET 7.0.10 (7.0.1023.36312), X64 RyuJIT AVX2 [AttachedDebugger]
  DefaultJob : .NET 7.0.10 (7.0.1023.36312), X64 RyuJIT AVX2

Expressions

Future goals

• Be able to create your own functions and variables in a simple way
• Add more functions, variables and operators
• Try to increase performance

Feedback and Bugs

If you find any bugs or have any suggestions, feel free to send them!