Files
preprocessor/docs.1/ref/list_append_d.html
Paul Mensonides cdc4be5256 initial revision
[SVN r15198]
2002-09-08 09:40:56 +00:00

87 lines
2.8 KiB
HTML

<html>
<head>
<title>BOOST_PP_LIST_APPEND_D</title>
<link rel="stylesheet" type="text/css" href="../styles.css">
<script language="javascript" type="text/javascript" src="../scripts.js"></script>
</head>
<body onload="init('sample');">
<div style="margin-left: 0px;">
The <b>BOOST_PP_LIST_APPEND_D</b> macro appends two <i>lists</i>.&nbsp;
It reenters <b>BOOST_PP_WHILE</b> with maximum efficiency.
</div>
<h4>Usage</h4>
<div class="code">
<b>BOOST_PP_LIST_APPEND_D</b>(<i>d</i>, <i>a</i>, <i>b</i>)
</div>
<h4>Arguments</h4>
<dl>
<dt>d</dt>
<dd>
The next available <b>BOOST_PP_WHILE</b> iteration.
</dd>
<dt>a</dt>
<dd>
The first <i>list</i>.
</dd>
<dt>b</dt>
<dd>
The second <i>list</i>.
</dd>
</dl>
<h4>Remarks</h4>
<div>
This macro appends two lists.&nbsp;
For example, if <i>a</i> is (<i>1</i>, (<i>2</i>, (<i>3</i>, <b>BOOST_PP_NIL</b>))) and <i>b</i> is (<i>4</i>, (<i>5</i>, <b>BOOST_PP_NIL</b>)),
this macro will expand to:
<div>
(<i>1</i>, (<i>2</i>, (<i>3</i>, (<i>4</i>, (<i>5</i>, <b>BOOST_PP_NIL</b>)))))
</div>
</div>
<h4>See Also</h4>
<ul>
<li><a href="list_append.html">BOOST_PP_LIST_APPEND</a></li>
</ul>
<h4>Requirements</h4>
<div>
<b>Header:</b> &nbsp;<a href="../headers/list/append.hpp.html">&lt;boost/preprocessor/list/append.hpp&gt;</a>
</div>
<h4><a class="local" onclick="toggle('sample');" onmouseover="change(this);" onmouseout="revert(this);">Sample Code</a></h4>
<div id="sample"><pre>
#include &lt;boost/preprocessor/arithmetic/dec.hpp&gt;
#include &lt;boost/preprocessor/control/while.hpp&gt;
#include &lt;boost/preprocessor/list/append.hpp&gt;
#include &lt;boost/preprocessor/tuple/elem.hpp&gt;
#define LIST (1, (2, (3, BOOST_PP_NIL)))
#define PRED(d, state) BOOST_PP_TUPLE_ELEM(3, 1, state)
#define OP(d, state) /* .................. */ \
( \
BOOST_PP_LIST_APPEND_D( \
d, BOOST_PP_TUPLE_ELEM(3, 0, state), \
BOOST_PP_TUPLE_ELEM(3, 2, state) \
), \
BOOST_PP_DEC( \
BOOST_PP_TUPLE_ELEM(3, 1, state) \
), \
BOOST_PP_TUPLE_ELEM(3, 2, state) \
) \
/**/
#define LIST_MULTIPLY(c, list) /* ... */ \
BOOST_PP_TUPLE_ELEM( \
3, 0, \
BOOST_PP_WHILE( \
PRED, OP, \
(BOOST_PP_NIL, c, list) \
) \
) \
/**/
LIST_MULTIPLY(3, LIST)
// expands to (1, (2, (3, (1, (2, (3, (1, (2, (3, BOOST_PP_NIL)))))))))
<pre></div>
</body>
</html>