Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codewriter-packages/expression-parser
Simple math expression parser library for Unity
https://github.com/codewriter-packages/expression-parser
c-sharp calculus expression-evaluator formula-parser gamedev math-parser mathematical-expression-parser mathematical-expressions-evaluator unity unity3d
Last synced: about 2 months ago
JSON representation
Simple math expression parser library for Unity
- Host: GitHub
- URL: https://github.com/codewriter-packages/expression-parser
- Owner: codewriter-packages
- License: mit
- Created: 2021-06-16T08:11:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-05-29T17:10:09.000Z (over 1 year ago)
- Last Synced: 2024-08-02T05:13:52.215Z (5 months ago)
- Topics: c-sharp, calculus, expression-evaluator, formula-parser, gamedev, math-parser, mathematical-expression-parser, mathematical-expressions-evaluator, unity, unity3d
- Language: C#
- Homepage:
- Size: 85 KB
- Stars: 49
- Watchers: 3
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Expression Parser [](#) [](#) 
_Simple expression parser library for unity_
## Quick Sample
```csharp
// create context
var context = new ExpresionContext();
// register some variables
context.RegisterVariable("a", () => 1);
context.RegisterVariable("b", () => 2);
context.RegisterVariable("c", () => 3);
var input = "a >= b AND NOT(b) OR (a + b) >= c";
// compile expression
var compiledExpr = FloatExpressionParser.Instance.Compile(input, context, true);
// execute expression
var result = compiledExpr.Invoke();
```
Create your own `ExpressionParser` implementation to support other data types
## Language Overview
#### Constants
| Input | Value |
| ----- | ----- |
| TRUE | 1 |
| FALSE | 0 |
#### Numbers
| Input | Value |
| ----- | ----- |
| 123 | 123.0 |
| 123.0 | 123.0 |
| 123.4 | 123.4 |
#### Operators
| Name | Sample | Precedence |
| ----------- | ------ | ---------- |
| Unary Minus | -2 | 0 |
| Power | 2 ^ 3 | 1 (!!!, -2^2 = (-2) ^ 2 = 4) |
| Multiply | 2 * 3 | 2 |
| Divide | 6 / 3 | 2 |
| Module | 5 % 3 | 2 |
| Addition | 2 + 3 | 3 |
| Subtraction | 3 - 2 | 3 |
| Less Than | 2 < 3 | 4 |
| Less Than Or Equal | 2 <= 3 | 4 |
| Greater Than | 2 > 3 | 4 |
| Greater Than Or Equal | 2 >= 3 | 4 |
| Equality | 2 = 3 | 5 |
| Inequality | 2 != 3 | 5 |
| Logical and | 2 > 1 AND 3 > 2 | 6 |
| Logical or | 2 = 3 OR 2 != 4 | 6 |
#### Variables
Creation of custom variables is supported.
Variable name must starts with english letter or underscore.
The rest of the variable name may also contains digits.
#### Functions
| Name | Sample | Description |
| ---- | --------- | ----------- |
| NOT | NOT(TRUE) | Returns FALSE if argument is true, otherwise TRUE |
| IF | IF(n < 5, 5, n < 25, 25, 50) | Returns the second argument if the first argument is true, returns the fourth argument if the third argument is true, and so on. Otherwise, returns the last argument. Odd number of arguments required |
| MIN | MIN(0, 1, ...) | Returns smallest argument |
| MAX | MAX(0, 1, ...) | Returns largest argument |
| ROUND | ROUND(1.1) | Rounds a number |
| CEILING | CEILING(1.1) | Round number up |
| FLOOR | FLOOR(1.1) | Rounds number down |
| LOG | LOG(8, 2) | Returns the logarithm to base B of number A |
## How to Install
Minimal Unity Version is 2020.1.
Library distributed as git package ([How to install package from git URL](https://docs.unity3d.com/Manual/upm-ui-giturl.html))
Git URL: `https://github.com/codewriter-packages/Expression-Parser.git`
## License
Expression-Parser is [MIT licensed](./LICENSE.md).