1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<head> 4<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5<title>Chapter 24. Boost.Metaparse</title> 6<link rel="stylesheet" href="../../doc/src/boostbook.css" type="text/css"> 7<meta name="generator" content="DocBook XSL Stylesheets V1.79.1"> 8<link rel="home" href="index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> 9<link rel="up" href="libraries.html" title="Part I. The Boost C++ Libraries (BoostBook Subset)"> 10<link rel="prev" href="tribool/tests.html" title="Testsuite"> 11<link rel="next" href="metaparse/related_publications_and_blogs.html" title="Related publications and blogs"> 12</head> 13<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> 14<table cellpadding="2" width="100%"><tr> 15<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../boost.png"></td> 16<td align="center"><a href="../../index.html">Home</a></td> 17<td align="center"><a href="../../libs/libraries.htm">Libraries</a></td> 18<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td> 19<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td> 20<td align="center"><a href="../../more/index.htm">More</a></td> 21</tr></table> 22<hr> 23<div class="spirit-nav"> 24<a accesskey="p" href="tribool/tests.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="metaparse/related_publications_and_blogs.html"><img src="../../doc/src/images/next.png" alt="Next"></a> 25</div> 26<div class="chapter"> 27<div class="titlepage"><div> 28<div><h2 class="title"> 29<a name="metaparse"></a>Chapter 24. Boost.Metaparse</h2></div> 30<div><div class="author"><h3 class="author"> 31<span class="firstname">Abel</span> <span class="surname">Sinkovics</span> 32</h3></div></div> 33<div><p class="copyright">Copyright © 2015 Abel Sinkovics</p></div> 34<div><div class="legalnotice"> 35<a name="metaparse.legal"></a><p> 36 Distributed under the Boost Software License, Version 1.0. (See accompanying 37 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>) 38 </p> 39</div></div> 40</div></div> 41<div class="toc"> 42<p><b>Table of Contents</b></p> 43<dl class="toc"> 44<dt><span class="section"><a href="metaparse.html#metaparse.description">Description</a></span></dt> 45<dt><span class="section"><a href="metaparse/related_publications_and_blogs.html">Related publications 46 and blogs</a></span></dt> 47<dt><span class="section"><a href="metaparse/preface.html">Preface</a></span></dt> 48<dd><dl> 49<dt><span class="section"><a href="metaparse/preface.html#metaparse.preface.description">Description</a></span></dt> 50<dt><span class="section"><a href="metaparse/preface.html#metaparse.preface.scope">Scope</a></span></dt> 51<dt><span class="section"><a href="metaparse/preface.html#metaparse.preface.advantages_of_using_this_library">Advantages 52 of using this library</a></span></dt> 53<dt><span class="section"><a href="metaparse/preface.html#metaparse.preface.cost_of_using_metaparse">Cost of using 54 Metaparse</a></span></dt> 55<dt><span class="section"><a href="metaparse/preface.html#metaparse.preface.supported_platforms">Supported platforms</a></span></dt> 56</dl></dd> 57<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html">Getting 58 started with Boost.Metaparse</a></span></dt> 59<dd><dl> 60<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.1_introduction">1. 61 Introduction</a></span></dt> 62<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.2_the_text_to_parse">2. 63 The text to parse</a></span></dt> 64<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.3_creating_a_simple_parser">3. 65 Creating a simple parser</a></span></dt> 66<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.4_parsing_simple_expressions">4. 67 Parsing simple expressions</a></span></dt> 68<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.5_parsing_longer_expressions">5. 69 Parsing longer expressions</a></span></dt> 70<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.6_adding_support_for_other_opera">6. 71 Adding support for other operators</a></span></dt> 72<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.7_dealing_with_precedence">7. 73 Dealing with precedence</a></span></dt> 74<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.8_dealing_with_associativity">8. 75 Dealing with associativity</a></span></dt> 76<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.9_dealing_with_unary_operators">9. 77 Dealing with unary operators</a></span></dt> 78<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.10_dealing_with_parens">10. 79 Dealing with parens</a></span></dt> 80<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.11_dealing_with_invalid_input">11. 81 Dealing with invalid input</a></span></dt> 82<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.12_summary">12. 83 Summary</a></span></dt> 84<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.copy_paste_friendly_code_example">Copy-paste 85 friendly code examples</a></span></dt> 86<dt><span class="section"><a href="metaparse/getting_started_with_boost_metap.html#metaparse.getting_started_with_boost_metap.definitions_before_each_section">Definitions 87 before each section</a></span></dt> 88</dl></dd> 89<dt><span class="section"><a href="metaparse/user_manual.html">User manual</a></span></dt> 90<dd><dl> 91<dt><span class="section"><a href="metaparse/user_manual.html#metaparse.user_manual.what_is_a_parser">What is a parser</a></span></dt> 92<dt><span class="section"><a href="metaparse/user_manual.html#metaparse.user_manual.parsing_based_on_constexpr">Parsing 93 based on <code class="computeroutput"><span class="keyword">constexpr</span></code></a></span></dt> 94<dt><span class="section"><a href="metaparse/user_manual.html#metaparse.user_manual.what_types_of_grammars_can_be_us">What 95 types of grammars can be used?</a></span></dt> 96</dl></dd> 97<dt><span class="section"><a href="metaparse/versioning.html">Versioning</a></span></dt> 98<dd><dl> 99<dt><span class="section"><a href="metaparse/versioning.html#metaparse.versioning.template_classes">Template classes</a></span></dt> 100<dt><span class="section"><a href="metaparse/versioning.html#metaparse.versioning.macros">Macros</a></span></dt> 101</dl></dd> 102<dt><span class="section"><a href="metaparse/performance.html">Performance</a></span></dt> 103<dd><dl> 104<dt><span class="section"><a href="metaparse/performance.html#metaparse.performance.benchmarks_of_boost_metaparse_st">Benchmarks 105 of BOOST_METAPARSE_STRING</a></span></dt> 106<dt><span class="section"><a href="metaparse/performance.html#metaparse.performance.measuring_printf">Measuring printf</a></span></dt> 107<dt><span class="section"><a href="metaparse/performance.html#metaparse.performance.further_measurements">Further measurements</a></span></dt> 108</dl></dd> 109<dt><span class="section"><a href="metaparse/the_design_of_the_library.html">The design of the 110 library</a></span></dt> 111<dd><dl><dt><span class="section"><a href="metaparse/the_design_of_the_library.html#metaparse.the_design_of_the_library.design_rationale">Design 112 rationale</a></span></dt></dl></dd> 113<dt><span class="section"><a href="metaparse/reference.html">Reference</a></span></dt> 114<dd><dl> 115<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.parsers_and_combinators_provided">Parsers 116 and combinators provided by the library</a></span></dt> 117<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.compile_time_data_structures_and">Compile-time 118 data structures and values</a></span></dt> 119<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.string">String</a></span></dt> 120<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.errors">Errors</a></span></dt> 121<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.tags">Tags</a></span></dt> 122<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.utilities">Utilities</a></span></dt> 123<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.terms_used_by_the_library">Terms 124 used by the library</a></span></dt> 125<dt><span class="section"><a href="metaparse/reference.html#metaparse.reference.alphabetical">Alphabetical</a></span></dt> 126</dl></dd> 127</dl> 128</div> 129<div class="section"> 130<div class="titlepage"><div><div><h2 class="title" style="clear: both"> 131<a name="metaparse.description"></a><a class="link" href="metaparse.html#metaparse.description" title="Description">Description</a> 132</h2></div></div></div> 133<p> 134 Metaparse is a parser generator library for template metaprograms. The purpose 135 of this library is to support the creation of parsers that parse at compile 136 time. This library is intended to be used for embedded domain specific language 137 creation for C++. The input of the generated parser is a compile time string, 138 see <a class="link" href="metaparse/reference.html#string"><code class="computeroutput"><span class="identifier">string</span></code></a>. 139 The result of the parsing process is either an error or any other result the 140 writer of the parser specifies. 141 </p> 142<p> 143 The library is similar to Boost.Spirit, however while parsers built with Spirit 144 parse at run-time, parsers built with Metaparse parse at compile-time. Parsers 145 built with Metaparse can output: 146 </p> 147<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> 148<li class="listitem"> 149 types 150 </li> 151<li class="listitem"> 152 constant values 153 </li> 154<li class="listitem"> 155 objects (types with public static members) 156 </li> 157<li class="listitem"> 158 callable C++ functions (types with public static method) 159 </li> 160<li class="listitem"> 161 template metafunction classes 162 </li> 163</ul></div> 164<p> 165 See section <a class="link" href="metaparse/user_manual.html#result_types">What can be built from a compile-time 166 string?</a> for further details. 167 </p> 168<p> 169 Based on C++11 features the library can provide advanced utilities for defining 170 the input string, the rest of the library works on C++98-based compilers as 171 well. Note that if you build the tests and examples with Boost.Build using 172 GCC or Clang, the compiler will not have C++11 (or newer) enabled. To build 173 the tests and examples in C++11-mode, you need to run <code class="computeroutput"><span class="identifier">b2</span> 174 <span class="identifier">cxxflags</span><span class="special">=</span><span class="string">"-std=c++11"</span></code>. 175 </p> 176<p> 177 An external tutorial can be found at <a href="https://github.com/sabel83/metaparse_tutorial#metaparse-tutorial" target="_top">https://github.com/sabel83/metaparse_tutorial#metaparse-tutorial</a> 178 </p> 179</div> 180</div> 181<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr> 182<td align="left"><p><small>Last revised: August 11, 2020 at 15:03:12 GMT</small></p></td> 183<td align="right"><div class="copyright-footer"></div></td> 184</tr></table> 185<hr> 186<div class="spirit-nav"> 187<a accesskey="p" href="tribool/tests.html"><img src="../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="libraries.html"><img src="../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="index.html"><img src="../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="metaparse/related_publications_and_blogs.html"><img src="../../doc/src/images/next.png" alt="Next"></a> 188</div> 189</body> 190</html> 191