mirror of
https://github.com/boostorg/preprocessor.git
synced 2025-07-01 06:50:59 +02:00
108 lines
4.7 KiB
HTML
108 lines
4.7 KiB
HTML
<html>
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
|
|
<link rel="stylesheet" type="text/css" href="../../../../boost.css">
|
|
<title>Boost.Preprocessor - Reference</title>
|
|
</head>
|
|
<body link="#0000ff" vlink="#800080">
|
|
<table border="0" cellpadding="7" cellspacing="0" width="100%" summary=
|
|
"header">
|
|
<tr>
|
|
<td valign="top" width="300">
|
|
<h3><a href="../../../../index.htm"><img height="86" width="277" alt="C++ Boost" src="../../../../c++boost.gif" border="0"></a></h3>
|
|
</td>
|
|
<td valign="top">
|
|
<h1 align="center">Boost.Preprocessor</h1>
|
|
<h2 align="center">Header <<a href="../../../../boost/preprocessor/while.hpp">boost/preprocessor/while.hpp</a>></h2>
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
|
|
<hr>
|
|
|
|
<a href="tuple_to_list.htm">Prev</a> <a href="arithmetic.htm">Next</a> <a href="index.htm#Macros">Macros</a> <a href="index.htm#Headers">Headers</a>
|
|
|
|
<hr>
|
|
|
|
<h3><a name="BOOST_PP_WHILE">#define BOOST_PP_WHILE</a>(PRED,OP,STATE)</h3>
|
|
<p>Iterates <code>OP(D,STATE)</code> while <code>PRED(D,STATE)</code> is true.</p>
|
|
|
|
<p>In other words, expands to:</p>
|
|
|
|
<pre>
|
|
OP(D, ... OP(D, OP(D,STATE) ) ... )
|
|
</pre>
|
|
|
|
<p>The depth of iteration is determined by <code>PRED(D,STATE)</code>.</p>
|
|
|
|
<p>For example,</p>
|
|
|
|
<pre>
|
|
#define PRED(D,STATE) <a href="comparison_less.htm#BOOST_PP_LESS_D">BOOST_PP_LESS_D</a>(D,<a href="tuple_elem.htm#BOOST_PP_TUPLE_ELEM">BOOST_PP_TUPLE_ELEM</a>(2,0,STATE),<a href="tuple_elem.htm#BOOST_PP_TUPLE_ELEM">BOOST_PP_TUPLE_ELEM</a>(2,1,STATE))
|
|
#define OP(D,STATE) (<a href="inc.htm#BOOST_PP_INC">BOOST_PP_INC</a>(<a href="tuple_elem.htm#BOOST_PP_TUPLE_ELEM">BOOST_PP_TUPLE_ELEM</a>(2,0,STATE)),<a href="tuple_elem.htm#BOOST_PP_TUPLE_ELEM">BOOST_PP_TUPLE_ELEM</a>(2,1,STATE))
|
|
<a href="while.htm#BOOST_PP_WHILE">BOOST_PP_WHILE</a>(PRED,OP,(0,3))
|
|
</pre>
|
|
|
|
<p>expands to:</p>
|
|
|
|
<pre>
|
|
(3,3)
|
|
</pre>
|
|
|
|
<h3>Legend</h3>
|
|
<ul>
|
|
<li><b>STATE</b> is the current state of iteration. The state is usually a tuple.</li>
|
|
<li><b>PRED</b> is the condition for iteration. It must expand to a decimal
|
|
integer literal.</li>
|
|
<li><b>OP</b> is the iterated macro. Note that if the state is a tuple, then
|
|
OP(D,STATE) usually expands to a tuple of the same number of elements.</li>
|
|
<li><b>D</b> is the recursion depth and should only be used as a parameter
|
|
to other macros using <a href="while.htm#BOOST_PP_WHILE">BOOST_PP_WHILE</a>(). Such macros include
|
|
<a href="arithmetic_add.htm#BOOST_PP_ADD">BOOST_PP_ADD</a>() and other arithmetic operations. For each macro using
|
|
<a href="while.htm#BOOST_PP_WHILE">BOOST_PP_WHILE</a>(), there is a version of the macro, distinguished by the
|
|
D suffix (e.g. <a href="arithmetic_add.htm#BOOST_PP_ADD_D">BOOST_PP_ADD_D</a>()), that accepts an additional recursion
|
|
depth as the first parameter. This technique is necessary to avoid
|
|
recursively expanding the same macro again, which is not permitted by the
|
|
C++ preprocessor.</li>
|
|
</ul>
|
|
|
|
<h3>Automatic recursion?</h3>
|
|
|
|
<p><a href="while.htm#BOOST_PP_WHILE">BOOST_PP_WHILE</a>() currently does not implement automatic recursion. The reason
|
|
for this is that it would lead to very poor performance. The automatic recursion
|
|
technique takes O(N) steps just to find out that the Nth recursion should be used.
|
|
This would dramatically effect the time complexity of macros using automatic
|
|
recursion.</p>
|
|
|
|
<h3>Note</h3>
|
|
<ul>
|
|
<li>The value of the D parameter may exceed <a href="limits.htm#BOOST_PP_LIMIT_MAG">BOOST_PP_LIMIT_MAG</a>.</li>
|
|
<li>Using <a href="while.htm#BOOST_PP_WHILE">BOOST_PP_WHILE</a>() is a bit tricky. This is due to the C++
|
|
preprocessor limitations. It is recommended to take a look at the
|
|
implementations of the various PREPROCESSOR library primitives
|
|
such as <a href="arithmetic_add.htm#BOOST_PP_ADD">BOOST_PP_ADD</a>() for additional examples.</li>
|
|
</ul>
|
|
|
|
<h3>Example</h3>
|
|
<ul>
|
|
<li><a href="../../example/count_down.c">count_down.c</a></li>
|
|
<li><a href="../../example/linear_fib.c">linear_fib.c</a></li>
|
|
<li><a href="../../example/delay.c">delay.c</a></li>
|
|
</ul>
|
|
|
|
<hr>
|
|
|
|
<a href="tuple_to_list.htm">Prev</a> <a href="arithmetic.htm">Next</a> <a href="index.htm#Macros">Macros</a> <a href="index.htm#Headers">Headers</a>
|
|
<hr>
|
|
|
|
<p>Revised <!--webbot bot="Timestamp" s-type="EDITED" s-format="%d %b %Y" startspan --><!--webbot bot="Timestamp" endspan i-checksum="15246" --></p>
|
|
|
|
<p><i>© Copyright <a href="http://www.housemarque.com">Housemarque Oy</a> 2002</i></p>
|
|
|
|
<p>Permission to copy, use, modify, sell and distribute this document is granted
|
|
provided this copyright notice appears in all copies. This document is provided
|
|
"as is" without express or implied warranty, and with no claim as to its suitability
|
|
for any purpose.</p>
|
|
|
|
</body></html>
|