Spirit Parser Framework

The Spirit Parser Framework is an object oriented recursive descent parser generator framework implemented using template metaprogramming techniques. Expression templates allow users to approximate the syntax of Extended Backus Naur Form (EBNF) completely in C++. Parser objects are composed through operator overloading and the result is a backtracking LL(∞) parser that is capable of parsing rather ambiguous grammars.

Spirit can be used for both lexing and parsing, together or separately.

This framework is part of the Boost libraries.

Operators

Because of limitations of the C++ language, the syntax of Spirit has been designed around the operator precedences of C++, while bearing resemblance to both EBNF and regular expressions.

Example

#include
#include
#include
#include

using namespace std;using namespace boost::spirit;

int main(void){ string input; cout << "Input a line. "; getline(cin, input); cout << "Got '" << input << "'. "; unsigned count = 0;

/* Next line parses the input (input.c_str()), using a parser constructed with the following semantics (identation matches source for clarity):

Zero or more occurrences of ( literal string "cat" ( when matched, increment the counter "count" ) or any character (to move on finding the next occurrence of "cat") ) */ parse(input.c_str(), *( str_p("cat") [ increment_a(count) ]
anychar_p )); /* The parser is constructed by the compiler using operator overloading and template matching, so the actual work is done within spirit::parse(), and the expression starting with * only initializes the rule object that the parse function uses. */ // last, show results. cout << "The input had " << count << " occurrences of 'cat' "; return 0;}

Of course, there are better algorithms suited for string searching,but this example gives an idea how to construct rules and attachactions to them.

External links

* [http://spirit.sourceforge.net Spirit parser framework SourceForge page]
* [http://www.boost.org/libs/spirit/index.html Documentation in the Boost project]
* [http://www.ddj.com/article/printableArticle.jhtml?articleID=184401692&dept_url=/cpp/ Review on Dr. Dobb's Journal]