Released "Exevalator": A Multilingual & Copyright-Free Expression Evaluator Library

We have released a new library "Exevalator" (an abbreviation for Expression-Evaluator) which enables you to calculate values of numerical expressions stored in string variables, on Java/C#/C++/Rust programs.

In the former part of this article, we will explain details of Exevalator. In addition, in the latter part, we will actually use Exevalator in Java/C#/C++/Rust.

What is Exevalator ?

First of all, we should clarify target users/readers of Exevalator and this article.

Exevalator is a "library", which is a component of software, available for developing your software/apps. Hence, target users of Exevalator (and target readers of this article) are people who developing some softwere/apps as a hobby or jobs.

Purpose of Exevalator

Let's get into details. When you are developing software, don't you want to calculate (evaluate) the value of a numerical expression stored in a string-type variable easily?

Where typical examples of expressions are as follows:

Calculating these expressions are required for: developing some kind of calculator apps, applying user-defined conversions to data, drawing graphs of numeric expressions/functions, and so on.

On such apps, internally, gets an inputted expression from an user, as a string-type value. So the situation "an expression is stored in a string-type variable, and you want to calculate the value of it" occurs practically.

However, most of compiled (not scripting) languages don't support such feature by default, so you are required to implement a calculation routine by yourself, or use a library providing such feature.

Exevalator is a very compact library to provide such feature on Java/Rust/C#/C++ programs.

Multilingual

Exevalator is available in multiple programming languages. The lis of currently supported languages are as follows:

Java  (Java 8 or later is required. The latest version Java 18 is already available.)

C#    (C# 8.0 or later is recommended)

C++  (C++17 or later is required)

Rust  (rustc 1.57.0 or later is recommended)

Also, in future, we may port Exevalator to other languages too. Source code structure of Exevalator is relatively simple (as explained later), so it is easy to port. Indeed, we had developed Exevalator in Java at first, and then we ported it to C#, Rust, and C++.

Compact, Easy to Use

Exevalator is very compact libary implemented as single-file, for each language. (Only for C++, a header file is also provided, so it consists of two-files.)

Copyright-Free

This library is released under the "Unlicense" license, which is almost the same as the so-called "copyright-free" (public domain).

Also, you can choose the CC0 license instead, if you want. The Unlicense and the CC0 is similar in that they are licenses to release something into the public domain, but their details are little different. Choose the one you want.

Hence, no need to pay any attention to license terms, for using Exevalator. It is the same for distributing/selling your apps which are using Exevalator. It is even the same for customizing/diverting source code of Exevalator.

Can Define Functions/Variables

Sometimes you may want to calculate the value of an expression like "x + 2", where "x" is an variable, of which value can be modified in/by your app or its users.

Exevalator supports defining such variables. You can define variables as many as you want. You also can decide their names freely.

Also, as many as you want, you can create functions available in expressions, e.g.: "x + f(y)". You can implement internal process of such functions freely, and decide its name freely.

High-Speed

Exevalator performs calculations at high-speed.

For example, as the score measured by a benchmark program (containd in the repository of Exevalaor) on the general mid-range PC, Exevalator can performs hundreds of millions times of numerical operations per each second (= hundreds MFLOGS).

Based on our experience, we consider that the above calculation speed is enough for performing a conversion for large data, for sampling coordinates (x,y) of a expression in dense points, and so on.

Compared with Vnano

By the way, as same as Exevalator, we are developing/distributing a script engine "Vnano" for embedded use in apps.

The above "Vnano" can also calculates numerical expressions. So, features of Exevalator and Vnano are duplicate in some extent. However, it does NOT mean that one is "overall better" than the other. It depends on the purpose that which one is better.

On the other hand, Vnano supports more features than Exevalator, though its implementation is more complex and larger. In addition, the maximum processing speed of Vnano is faster than it of Exevalator.

Details of differences between Exevalator and Vnano are as follows:

Rughly summarized as follows: If you want to develop an highly customizable app, we recommend to try to use Vnano. On the other hand, what you want to do is only to calculate a value of a numerical expression, we recommend to use Exevalator.
(Please note that, Exevalator is available in Java/C#/C++/Rust, but Vnano is currently available in only Java.)

Let's Use Exevalator Actually

That's all about introduction of Exevalator. From here, Let's try to use Exevalator actually.

Download

At first, download the source code of Exevalator. You can get it from the following webpage on GitHub:

Download Page of Released Versions, in Source Code Repository of Exevalator on GitHub

https://github.com/RINEARN/exevalator/releases

On the above page, go to the section of a released version you want to use (the latest version is recommended), and click the hyperlink "Source code (zip)" in there.

Then, a ZIP file "exevalator-1.0.0.zip" (the actual name depends on the selected version) will be download, so right-click it and select "Extract All" to extract contents.

A folder "exevalator-..." will be created as the result of the above. In the folder, there are various files (e.g.: README, example files, and so on), but only following files are necessary to embed Exevalator into your apps.

Let's use in each language.

For Java Apps

For using in Java, put "Exevalator.java" into the same folder with the source file of a class in which you want to calculate expressions. If necessary, the same as when you create a new class, update build-settings to include "Exevalator.java" in compilation target.

In addition, append a package-declaration line "package ..." at the top of code of "Exevalator.java". The content of line depends where the file is locating, but it is the same as it of source files in the same folder. As an example, here we assume that the package is declared as follows:

Then, you can "import" Exevalator from other classes, and perform calculations as follows:

For more detailed explanation, and how to compile/run example code, see README for Java in repository.

For C# Apps

For using in C#, put "Exevalator.cs" into source code folder of your project to develop an app. If necessary, the same as when you create a new class, update build-settings to include "Exevalator.cs" in compilation target.

Then, you can "using" Exevalator from other source files, and perform calculations as follows:

For more detailed explanation, and how to compile/run example code, see README for C# in repository.

For C++ Apps

For using in C++, put "exevalator.cpp" and "exevalator.hpp" into the same folder with the source file in which you want to calculate expressions.

Then, you can "include" them from other source files, and perform calculations as follows:

For more detailed explanation, and how to compile/run example code, see README for C++ in repository.

For Rust Apps

For using in Rust, put "exevalator.rs" at the root-hierarchy of source code folder. (If you want to put it at other hierarchy, you are required to modify "mod" declarations appropriately.)

Then, you can "use" Exevalator in other source files, and perform calculations as follows:

For more detailed explanation, and how to compile/run example code, see README for Rust in repository.

---

That's all. When there is additional information about Exevalator, we will report it in this "RINEARN News" category. Exevalator is an open source library, so we will probably publish an article explaining details of software architecture of it, at a later date.