ExpressionEvaluator
A Simple Math and Pseudo C# Expression Evaluator in One C# File.
And from version 1.2.0 can execute small C# like scripts
It is largely based on and inspired by the following resourcesΒ this post on stackoverflow, NCalc, C# Operators and C# Statement Keywords
Status
| Branch | Status |
|---|---|
| master | |
| dev | |
| nuget |  |
Features
- Basic mathematical and logical expression evaluation
- System.Math methods and constants directly available (some like Max, Min, Avg are improved)
- Some useful functions for example to create List and Arrays
- Custom variables definition
- On the fly variables and functions evaluation (To easily extend possibilities, Manage also on instance Property and Methods)
- A large set of C# operators availables
- Instance and static methods and properties access like as in C#
- You can call Methods and/or Properties on your own classes (just pass a object as custom variables)
- C# primary types
- Use strings as in C# (
@"",$"",$@""available) - Lambda expressions
- Classes like File, Directory, Regex, List ... available (You can extend the list of Namespaces)
- Create instance with new(MyClassName, constructorArgs) or new MyClassName(constructorArgs)
- Call void methods with fluid prefix convention to chain operations
- Manage ExpandoObject
- Create custom Operators or change the parsing process
And with ScriptEvaluate method
- Small C# like script evaluation (Multi expressions separated by ; )
- Some conditional and loop blocks keywords (if, while, for, foreach ...)
- Multi-line (multi expression) Lambda expressions. (Can be use as method See #72 Declare methods in scripts and the doc)
Resources
Similar projects
Free
- NCalc
- Jint Support scripting but with Javascript
- NLua use Lua language in C#
- MoonSharp
- DynamicExpresso
- Flee
- Jace.Net
- Calculator
- Westwind.Scripting
- CS-Script Best alternative (I use it some times) -> Real C# scripts better than ExpressionEvaluator (But everything is compiled. Read the doc. Execution is faster but compilation can make it very slow. And if not done the right way, it can lead to memory leaks)
- Roslyn The Microsoft official solution (For scripting see)
- MathParser expression tree compiler and interpreter for math expressions. Heavily inspired by Roslyn.
- YoowzxCalc
- Scriban
- WattleScript
- AngouriMath For advanced Math in C#
- Fluid
- ClearScript
- Expressive
- IronPython to execute python in .Net or .Net in python
Commercial
- Eval Expression.NET
- mXparser (dual licensing) (Free for open source)
Projects that could help you build your own expression/script evaluator
Reading and resources
- Crafting interpreters
- Building a compiler An excellent Youtube tutorial
- Search for LEX, YACC, AST, Syntaxic trees...
I would say every C# evaluation libraries have drawbacks and benefits, ExpressionEvaluator is not an exception so choose wisely (Read docs and licences).
The biggest difference of ExpressionEvaluator is that everything is evaluated on the fly, nothing is compiled or transpile nor in CLR/JIT/IL nor in lambda expressions nor in javascript or other languages stuffs. So it can be slower in some cases (sometimes not) but it also avoid a lot of memory leaks. It is clearly not optimized for big reuse of expressions as the expression is reevaluated every time (Filtering on big dataset for example). It already allow to evaluate some small scripts. If you don't want an another .dll file in your project, you only need to copy one C# file in your project. And it's MIT licence
Donate
Expression Evaluator is free and will always be.
But if you want to say thanks for this lib with a donation or small sponsoring here you can :
Donate
Thank you anyway for using ExpressionEvaluator