123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476 |
- <html>
- <head>
- <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
- <title>Chapter 1. The Variadic Macro Data Library 1.9</title>
- <link rel="stylesheet" href="../../../../doc/src/boostbook.css" type="text/css">
- <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
- <link rel="home" href="index.html" title="Chapter 1. The Variadic Macro Data Library 1.9">
- <link rel="next" href="variadic_macro_data/vmd_naming.html" title="Naming conventions">
- </head>
- <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
- <table cellpadding="2" width="100%"><tr>
- <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../boost.png"></td>
- <td align="center"><a href="../../../../index.html">Home</a></td>
- <td align="center"><a href="../../../../libs/libraries.htm">Libraries</a></td>
- <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
- <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
- <td align="center"><a href="../../../../more/index.htm">More</a></td>
- </tr></table>
- <hr>
- <div class="spirit-nav"><a accesskey="n" href="variadic_macro_data/vmd_naming.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
- <div class="chapter">
- <div class="titlepage"><div>
- <div><h2 class="title">
- <a name="variadic_macro_data"></a>Chapter 1. The Variadic Macro Data Library 1.9</h2></div>
- <div><div class="author"><h3 class="author">
- <span class="firstname">Edward</span> <span class="surname">Diener</span>
- </h3></div></div>
- <div><p class="copyright">Copyright © 2010-2017 Tropic Software
- East Inc</p></div>
- </div></div>
- <div class="toc">
- <p><b>Table of Contents</b></p>
- <dl class="toc">
- <dt><span class="section"><a href="index.html#variadic_macro_data.vmd_intro">Introduction</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_naming.html">Naming conventions</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_whyhow.html">Why and how to use</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_vmacros.html">Using variadic macros</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_vc.html">Visual C++ define</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_detail.html">Functional groups</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_data_types.html">Data types</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific.html">Specific macros for working
- with data types</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific.html#variadic_macro_data.vmd_specific.vmd_test_empty">Emptiness</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_constraints.html">Macro
- constraints</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_identifier.html">Identifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_number.html">Numbers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_type.html">Types</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_pp_data_types.html">VMD
- and Boost PP data types</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_specific/vmd_identifying.html">Identifying
- data types</a></span></dt>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic.html">Generic macros for working
- with data types</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic.html#variadic_macro_data.vmd_generic.vmd_sequence">Parsing
- sequences</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic.html#variadic_macro_data.vmd_generic.vmd_sequence.vmd_sequence_convert">Converting
- sequences</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic.html#variadic_macro_data.vmd_generic.vmd_sequence.vmd_sequence_access">Accessing
- a sequence element</a></span></dt>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic/vmd_convert_sequence.html">Getting
- the type of data</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_generic/vmd_assert.html">Testing for
- equality and inequality</a></span></dt>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers.html">Macros with modifiers</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers.html#variadic_macro_data.vmd_modifiers.vmd_modifiers_return_type">Return
- type modifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers/vmd_modifiers_filter.html">Filtering
- modifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers/vmd_modifiers_identifier.html">Identifier
- modifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers/vmd_modifiers_splitting.html">Splitting
- modifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers/vmd_modifiers_index.html">Index
- modifiers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_modifiers/vmd_modifiers_single.html">Modifiers
- and the single-element sequence</a></span></dt>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_identifier_subtype.html">Identifier
- subtypes</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_useful.html">Useful variadic macros
- not in Boost PP</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data/vmd_useful.html#variadic_macro_data.vmd_useful.vmd_assert">Asserting
- and data types</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_useful/vmd_identity.html">Generating
- emptiness and identity</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_useful/vmd_empty_ppdata.html">Functionality
- for "empty" seqs and tuples</a></span></dt>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_internal_macros.html">Controlling internal
- usage</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_reentrant.html">Boost PP re-entrant
- versions</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_dynamic_typing.html">Input as dynamic
- types</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_vc_isms.html">Visual C++ gotchas in
- VMD</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_conv.html">Version 1.7 to 1.8 conversion</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_examples.html">Examples using VMD functionality</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data_reference.html">Variadic Macro Data Reference</a></span></dt>
- <dd><dl>
- <dt><span class="section"><a href="variadic_macro_data_reference.html#header.boost.vmd.array.to_seq_hpp">Header <boost/vmd/array/to_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/list/to_seq_hpp.html">Header <boost/vmd/list/to_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/to_seq_hpp.html">Header <boost/vmd/to_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/to_seq_hpp.html">Header <boost/vmd/tuple/to_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/array/to_tuple_hpp.html">Header <boost/vmd/array/to_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/list/to_tuple_hpp.html">Header <boost/vmd/list/to_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/to_tuple_hpp.html">Header <boost/vmd/seq/to_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/to_tuple_hpp.html">Header <boost/vmd/to_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_hpp.html">Header <boost/vmd/assert.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_array_hpp.html">Header <boost/vmd/assert_is_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_empty_hpp.html">Header <boost/vmd/assert_is_empty.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_identifier_hpp.html">Header <boost/vmd/assert_is_identifier.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_list_hpp.html">Header <boost/vmd/assert_is_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_number_hpp.html">Header <boost/vmd/assert_is_number.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_seq_hpp.html">Header <boost/vmd/assert_is_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_tuple_hpp.html">Header <boost/vmd/assert_is_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/assert_is_type_hpp.html">Header <boost/vmd/assert_is_type.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/elem_hpp.html">Header <boost/vmd/elem.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/empty_hpp.html">Header <boost/vmd/empty.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/enum_hpp.html">Header <boost/vmd/enum.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/equal_hpp.html">Header <boost/vmd/equal.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/get_type_hpp.html">Header <boost/vmd/get_type.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/identity_hpp.html">Header <boost/vmd/identity.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_array_hpp.html">Header <boost/vmd/is_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_empty_hpp.html">Header <boost/vmd/is_empty.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_empty_array_hpp.html">Header <boost/vmd/is_empty_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_empty_list_hpp.html">Header <boost/vmd/is_empty_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_identifier_hpp.html">Header <boost/vmd/is_identifier.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_list_hpp.html">Header <boost/vmd/is_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_multi_hpp.html">Header <boost/vmd/is_multi.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_number_hpp.html">Header <boost/vmd/is_number.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_parens_empty_hpp.html">Header <boost/vmd/is_parens_empty.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_seq_hpp.html">Header <boost/vmd/is_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_tuple_hpp.html">Header <boost/vmd/is_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_type_hpp.html">Header <boost/vmd/is_type.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/is_unary_hpp.html">Header <boost/vmd/is_unary.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/not_equal_hpp.html">Header <boost/vmd/not_equal.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/is_vmd_seq_hpp.html">Header <boost/vmd/seq/is_vmd_seq.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/pop_back_hpp.html">Header <boost/vmd/seq/pop_back.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/pop_back_hpp.html">Header <boost/vmd/tuple/pop_back.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/pop_front_hpp.html">Header <boost/vmd/seq/pop_front.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/pop_front_hpp.html">Header <boost/vmd/tuple/pop_front.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/push_back_hpp.html">Header <boost/vmd/seq/push_back.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/push_back_hpp.html">Header <boost/vmd/tuple/push_back.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/push_front_hpp.html">Header <boost/vmd/seq/push_front.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/push_front_hpp.html">Header <boost/vmd/tuple/push_front.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/remove_hpp.html">Header <boost/vmd/seq/remove.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/remove_hpp.html">Header <boost/vmd/tuple/remove.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/size_hpp.html">Header <boost/vmd/seq/size.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/size_hpp.html">Header <boost/vmd/size.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/size_hpp.html">Header <boost/vmd/tuple/size.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/to_array_hpp.html">Header <boost/vmd/seq/to_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/to_array_hpp.html">Header <boost/vmd/to_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/to_array_hpp.html">Header <boost/vmd/tuple/to_array.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/seq/to_list_hpp.html">Header <boost/vmd/seq/to_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/to_list_hpp.html">Header <boost/vmd/to_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/to_list_hpp.html">Header <boost/vmd/tuple/to_list.hpp></a></span></dt>
- <dd><dl></dl></dd>
- <dt><span class="section"><a href="header/boost/vmd/tuple/is_vmd_tuple_hpp.html">Header <boost/vmd/tuple/is_vmd_tuple.hpp></a></span></dt>
- <dd><dl></dl></dd>
- </dl></dd>
- <dt><span class="section"><a href="variadic_macro_data/vmd_design.html">Design</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_compilers.html">Compilers</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_history.html">History</a></span></dt>
- <dt><span class="section"><a href="variadic_macro_data/vmd_ack.html">Acknowledgements</a></span></dt>
- <dt><span class="section"><a href="index/s24.html">Index</a></span></dt>
- </dl>
- </div>
- <div class="section">
- <div class="titlepage"><div><div><h2 class="title" style="clear: both">
- <a name="variadic_macro_data.vmd_intro"></a><a class="link" href="index.html#variadic_macro_data.vmd_intro" title="Introduction">Introduction</a>
- </h2></div></div></div>
- <p>
- Welcome to the Variadic Macro Data library.
- </p>
- <p>
- The Variadic Macro Data library, referred to hereafter as VMD for short, is
- a library of variadic macros which provide enhancements to the functionality
- in the Boost preprocessor library ( Boost PP ), especially as it relates to
- preprocessor data types.
- </p>
- <p>
- The preprocessor data types with which VMD has specific functionality are emptiness,
- identifiers, numbers ( a subset of identifiers ), types ( a subset of identifiers
- ), Boost PP arrays, Boost PP lists, Boost PP seqs, Boost PP tuples, and sequences.
- The first four are basic preprocessor data types while the latter five are
- composite preprocessor data types. A sequence is zero or more of the other
- preprocessor data types following each other.
- </p>
- <h4>
- <a name="variadic_macro_data.vmd_intro.h0"></a>
- <span class="phrase"><a name="variadic_macro_data.vmd_intro.data_type_examples"></a></span><a class="link" href="index.html#variadic_macro_data.vmd_intro.data_type_examples">Data
- type examples</a>
- </h4>
- <div class="table">
- <a name="variadic_macro_data.vmd_intro.dwe"></a><p class="title"><b>Table 1.1. Data types with examples</b></p>
- <div class="table-contents"><table class="table" summary="Data types with examples">
- <colgroup>
- <col>
- <col>
- </colgroup>
- <thead><tr>
- <th>
- <p>
- Type
- </p>
- </th>
- <th>
- <p>
- Example
- </p>
- </th>
- </tr></thead>
- <tbody>
- <tr>
- <td>
- <p>
- identifier
- </p>
- </td>
- <td>
- <p>
- anyname
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- number
- </p>
- </td>
- <td>
- <p>
- 47
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- type
- </p>
- </td>
- <td>
- <p>
- BOOST_VMD_TYPE_NUMBER
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- array
- </p>
- </td>
- <td>
- <p>
- (4,(an_identifier,156,BOOST_VMD_TYPE_IDENTIFIER))
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- list
- </p>
- </td>
- <td>
- <p>
- (78,(some_identifier,(BOOST_VMD_TYPE_TYPE,BOOST_PP_NIL)))
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- seq
- </p>
- </td>
- <td>
- <p>
- (identifier)(89)(245)
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- tuple
- </p>
- </td>
- <td>
- <p>
- (any_id,175,BOOST_VMD_TYPE_LIST,happy,21)
- </p>
- </td>
- </tr>
- <tr>
- <td>
- <p>
- sequence
- </p>
- </td>
- <td>
- <p>
- tree 59 (56,BOOST_VMD_TYPE_SEQ) (128)(fire)(clown) (47,(BOOST_VMD_TYPE_TUPLE,BOOST_PP_NIL))
- </p>
- </td>
- </tr>
- </tbody>
- </table></div>
- </div>
- <br class="table-break"><p>
- Emptiness is the lack of any preprocessing tokens. A macro which expands to
- nothing, as in:
- </p>
- <pre class="programlisting"><span class="preprocessor">#define</span> <span class="identifier">RETURN_NOTHING</span><span class="special">(</span><span class="identifier">x</span><span class="special">)</span>
- </pre>
- <p>
- is said to return emptiness. Conversely a macro could accept nothing when invoked,
- such as in:
- </p>
- <pre class="programlisting"><span class="identifier">RETURN_NOTHING</span><span class="special">()</span>
- </pre>
- <p>
- Finally emptiness can be part of any composite data type as in:
- </p>
- <pre class="programlisting"><span class="special">(</span><span class="number">45</span><span class="special">,,</span><span class="identifier">some_name</span><span class="special">)</span>
- </pre>
- <p>
- where the second tuple element is empty.
- </p>
- <h4>
- <a name="variadic_macro_data.vmd_intro.h1"></a>
- <span class="phrase"><a name="variadic_macro_data.vmd_intro.what_is_the_advantage"></a></span><a class="link" href="index.html#variadic_macro_data.vmd_intro.what_is_the_advantage">What
- is the advantage ?</a>
- </h4>
- <p>
- VMD can identify any of the preprocessor data types previously mentioned, and
- can parse sequences into their individual preprocessor data types. You may
- well ask why that is important.
- </p>
- <p>
- In Boost PP macro programming a great deal of the control logic of designing
- a macro is based on the support Boost PP has for numbers and testing for the
- value of a number, in particular 0 and 1 to represent boolean choices. Essentially
- Boost PP often uses the value of a number to control the logic in a macro's
- design.
- </p>
- <p>
- VMD does not attempt, in any way, to duplicate Boost PP's support for testing
- the value of numbers or of the boolean 0 or 1 values, but just reuses that
- functionality. What VMD offers, which goes beyond Boost PP, is a system for
- deciphering the preprocessor data types, as well as comparing any of the preprocessor
- data types for equality to any given value. This allows macro logic to be designed
- in a more flexible way, relying on the type of data and/or the value of the
- data. If this intrigues you, continue reading to understand how you can use
- VMD to do macro programming.
- </p>
- <h4>
- <a name="variadic_macro_data.vmd_intro.h2"></a>
- <span class="phrase"><a name="variadic_macro_data.vmd_intro.functionality_areas"></a></span><a class="link" href="index.html#variadic_macro_data.vmd_intro.functionality_areas">Functionality
- areas</a>
- </h4>
- <p>
- The functionality of the library may be summed up as:
- </p>
- <div class="orderedlist"><ol class="orderedlist" type="1">
- <li class="listitem">
- Provide a better way of testing for and using empty parameters and empty
- preprocessor data.
- </li>
- <li class="listitem">
- Provide ways for testing/parsing for identifiers, numbers, types, tuples,
- arrays, lists, and seqs.
- </li>
- <li class="listitem">
- Provide ways for testing/parsing sequences of identifiers, numbers, types,
- tuples, arrays, lists. and seqs.
- </li>
- <li class="listitem">
- Provide some useful variadic macros not in Boost PP.
- </li>
- </ol></div>
- <p>
- The library is a header only library and all macros in the library are included
- by a single header, whose name is 'vmd.hpp'. Individual headers may be used
- for different functionality in the library and will be denoted when that functionality
- is explained.
- </p>
- <p>
- All the macros in the library begin with the sequence 'BOOST_VMD_' to distinguish
- them from other macros the end-user might use. Therefore the end-user should
- not use any C++ identifiers, whether in macros or otherwise, which being with
- the sequence 'BOOST_VMD_'.
- </p>
- <p>
- Use of the library is only dependent on Boost PP. The library also uses Boost
- detail lightweight_test.hpp for its own tests.
- </p>
- </div>
- </div>
- <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
- <td align="left"><p><small>Last revised: December 10, 2019 at 00:21:47 GMT</small></p></td>
- <td align="right"><div class="copyright-footer"></div></td>
- </tr></table>
- <hr>
- <div class="spirit-nav"><a accesskey="n" href="variadic_macro_data/vmd_naming.html"><img src="../../../../doc/src/images/next.png" alt="Next"></a></div>
- </body>
- </html>
|