acd-arithmetic 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);
    }
}
Authors:
  • Anton Curmanschii
Dependencies:
emsi_containers
Versions:
0.0.4 2022-Dec-07
0.0.3 2022-Nov-05
0.0.2 2022-Oct-30
~master 2022-Dec-07
Show all 4 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 25 downloads total

Score:
0.3
Short URL:
acd-arithmetic.dub.pm