acdarithmetic 0.0.2
Arithmetic expressions library
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
Arithmetic expression parser
This library is a powerful recursive descent arithmetic expression parser. The precedence is handled via the concept of precedence climbing.
The precedence and associativity is only handled for binary operators, unary operators are always handled as right associative and as having infinite precedence.
Features:
 Lexing and parsing of an expression to a syntax tree;
 Evalutation of a parsed expression;
 The symbol table is separated from the syntax tree, which basically makes parsed expressions safe to use in multithreaded contexts, given the threads use a different symbol table.
Unimplemented features:
 Ease of use and full coverage of allocators;
 Syntax tree optimizations;
 Expression compilation to native code;
 Allow multilayered symbol tables with a fallback lookup mechanism, so you don't have to copy the symbols to the new table;
 Better error handling (currently an error handler is used to display errors, but it could be better);
 A configuration mechanism for building the right lexers and parsers.
I won't promise the library is the fastest or the best there is, but it will get the job done for basic applications for sure.
Example
import std.stdio;
import acd.arithmetic;
void main()
{
// The default operators include the basic arithmetic operators.
OperatorGroup[] operatorGroups = createDefaultOperatorGroups();
auto expressionTree = parseExpression("x + y ^ 2 * sin(x)", operatorGroups);
if (expressionTree.thereHaveBeenErrors  expressionTree.root is null)
{
writeln("Error parsing expression");
return;
}
// Prints the expression back in text form.
writeExpression(expressionTree.root);
// The default symbol table includes trig functions, the constants pi and e,
// and some common math functions.
SymbolTable!double symbolTable = createDefaultSymbolTable();
// You can add your own values for the variables or constants.
symbolTable
.set("x").value(1.0)
.set("y").value(2.0);
// You can also add your own functions.
symbolTable
.set("square").functions!(x => x ^^ 2);
{
double result = eval(symbolTable, expressionTree.root);
writeln(result);
}
// Can change values
symbolTable.set("x").value(2.0);
{
double result = eval(symbolTable, expressionTree.root);
writeln(result);
}
// Can reuse the symbol table for other expressions
expressionTree = parseExpression("x * cos(y)", operatorGroups);
if (expressionTree.thereHaveBeenErrors  expressionTree.root is null)
{
writeln("Error parsing expression");
return;
}
{
double result = eval(symbolTable, expressionTree.root);
writeln(result);
}
}
 Registered by Anton Curmanschii
 0.0.2 released 5 months ago
 AntonC9018/acd.arithmetic
 MIT
 Copyright © 2022, Anton
 Authors:
 Dependencies:
 emsi_containers
 Versions:

0.0.4 2022Dec07 0.0.3 2022Nov05 0.0.2 2022Oct30 ~master 2022Dec07  Download Stats:


0 downloads today

0 downloads this week

0 downloads this month

21 downloads total

 Score:
 0.3
 Short URL:
 acdarithmetic.dub.pm