parser's Introduction

parser

This is a parser combinator library for C++. As a quick example of use, here is a complete program that parses one or more doubles separated by commas, ignoring whitespace:

#include <boost/parser/parser.hpp>

#include <iostream>
#include <string>


namespace bp = boost::parser;

int main()
{
    std::cout << "Enter a list of doubles, separated by commas.  No pressure. ";
    std::string input;
    std::getline(std::cin, input);

    auto const result = bp::parse(
        input, bp::double_ >> *(',' >> bp::double_), bp::ws);

    if (result) {
        std::cout << "Great! It looks like you entered:\n";
        for (double x : *result) {
            std::cout << x << "\n";
        }
    } else {
        std::cout
            << "Good job!  Please proceed to the recovery annex for cake.\n";
    }
}

This library is header-only, and has a default dependency on Boost.Hana. The Boost.Hana dependency can be eliminated, and std::tuple will be used instead of boost::hana::tuple throughout the library, if you #define BOOST_PARSER_DISABLE_HANA_TUPLE. To try out the lib without mseeing with dependencies, add its include/ dir as an include path in your build and define BOOST_PARSER_DISABLE_HANA_TUPLE your build.

Features:

Parsers that parse a variety of things.
Combining operations that make complex parsers out of simpler ones.
Multiple ways of getting data out of the parse, including via callbacks.
Sentinel- and range-friendly.
Very Unicode friendliness.
Excellent error reporting, via diagnostics like those produced by GCC and Clang.
Trace support for debugging your parsers.
Clever hacks to make compile time errors easier to deal with. (These are totally optional.)

This library targets submission to Boost.

Online docs: https://tzlaine.github.io/parser

Master status: