https://github.com/expr4j/expr4j

Java library to evaluate mathematical expressions
https://github.com/expr4j/expr4j

expression-evaluator java shunting-yard shunting-yard-algorithm

Last synced: 8 months ago
JSON representation

Java library to evaluate mathematical expressions

• Host: GitHub
• URL: https://github.com/expr4j/expr4j
• Owner: expr4j
• License: apache-2.0
• Created: 2019-09-05T15:19:39.000Z (almost 7 years ago)
• Default Branch: main
• Last Pushed: 2023-08-25T23:23:43.000Z (almost 3 years ago)
• Last Synced: 2025-07-23T03:47:35.140Z (11 months ago)
• Topics: expression-evaluator, java, shunting-yard, shunting-yard-algorithm
• Language: Java
• Homepage: https://expr4j.pratanumandal.in/
• Size: 590 KB
• Stars: 24
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          


    

    



# Expression Evaluator for Java

![Maven](https://github.com/expr4j/expr4j/actions/workflows/maven.yml/badge.svg)

Expr4j is a Java library to parse and evaluate mathematical expression strings.

The expressions are evaluated using [Dijkstra's Shunting Yard algorithm](https://en.wikipedia.org/wiki/Shunting-yard_algorithm). An expression tree is created from the postfix (or RPN) expression which is then parsed to evaluate the expression. The library is written entirely using generics so it can be used with any type of operands.

Predefined implementations are provided in the packages [expr4j-double](https://github.com/expr4j/expr4j-double), [expr4j-bigdecimal](https://github.com/expr4j/expr4j-bigdecimal), and [expr4j-complex](https://github.com/expr4j/expr4j-complex).

> **Note**


> Version 1.x of Expr4j is a complete rewrite of the library. The new API is incompatible with the 0.0.x versions.




## Key Features

- Supports numerical functions, operations, constants, and variables.

- Written using generics to allow easy extension for any type of operands including user defined types.

- Multiple predefined implementations including BigDecimal and Complex numbers.

- Supports addition of custom functions and operators.

- Functions can be defined with a variable number of arguments.

- Supports implicit multiplication, ex: `2x` is treated as `2*x` and `(a+b)(a-b)` is treated as `(a+b)*(a-b)`.

- Supports lazy evaluation of functions and operators for improved performance.

- Supports asynchronous evaluation for improved performance.

- Supports scientific notations of numbers.




## Dependency Management

### Maven

```xml

    in.pratanumandal

    expr4j

    1.0

```

### Gradle

```gradle

dependencies {

    implementation 'in.pratanumandal:expr4j:1.0'

}

```