Micro Parser Combinators

mpc is a lightweight Parser Combinator library for C.

The current main alternative is a branch of (https://github.com/wbhart/Cesium3)[Cesium3].

Features & Advantages

• Error Message Support
• Regular Expression Support
• Parser Grammar Support
• Works for Generic Types
• AST Extension
• Single source & header files
• Written in clean ANSI C
• Doesn't rely on Boehm-Demers-Weiser Garbage Collection
• Doesn't use setjmp and longjmp for errors
• Doesn't pollute namespace

Example

mpc_val_t* combine_maths(int n, mpc_val_t** xs) {
  
  int** vs = (int**)xs;
  
  if (*vs[1] == '*') { *vs[0] *= *vs[2]; }
  if (*vs[1] == '/') { *vs[0] /= *vs[2]; }
  if (*vs[1] == '+') { *vs[0] += *vs[2]; }
  if (*vs[1] == '-') { *vs[0] -= *vs[2]; }
  
  free(vs[1]);
  free(vs[2]);
  
  return vs[0];
}

int main(int argc, char** argv) {

  mpc_parser_t* Expr   = mpc_new();
  mpc_parser_t* Factor = mpc_new();
  mpc_parser_t* Term   = mpc_new();
  mpc_parser_t* Maths  = mpc_new();

  mpc_define(Expr,
    mpc_pc("cmaths ( fact ['*' | '/'] fact ) | fact", 
      combine_maths, Factor, free, Factor, free, Factor),
  );
  
  mpc_define(Factor,
    mpc_pc("cmaths ( term ['+' | '-'] term ) | term", 
      combine_maths, Term, free, Term, free, Term),
  );
  
  mpc_define(Term,
    mpc_pc("num | snd ('(' expr ')')", 
      mpc_int(), mpcf_asnd_free, Expr, free)
  );
  
  mpc_define(Maths, mpc_ends(Expr, free));
  
  mpc_delete(Expr);
  mpc_delete(Factor);
  mpc_delete(Term);
  mpc_delete(Maths);
  
}

Parsers

Combinators

Regular Expressions

Combinator Grammars

Abstract Syntax Tree

Reference