3 <title>BOOST_PP_REPEAT
</title>
4 <link rel=
"stylesheet" type=
"text/css" href=
"../styles.css">
7 <div style=
"margin-left: 0px;">
8 The
<b>BOOST_PP_REPEAT
</b> macro represents a fast horizontal repetition construct.
12 <b>BOOST_PP_REPEAT
</b>(
<i>count
</i>,
<i>macro
</i>,
<i>data
</i>)
18 The number of repetitious calls to
<i>macro
</i>.
19 Valid values range from
<i>0</i> to
<b>BOOST_PP_LIMIT_REPEAT
</b>.
23 A ternary operation of the form
<i>macro
</i>(
<i>z
</i>,
<i>n
</i>,
<i>data
</i>).
24 This macro is expanded by
<b>BOOST_PP_REPEAT
</b> with the next available repetition depth,
25 the current repetition number, and the auxiliary
<i>data
</i> argument.
29 Auxiliary data passed to
<i>macro
</i>.
34 This macro expands to the sequence:
36 <i>macro
</i>(
<i>z
</i>,
<i>0</i>,
<i>data
</i>)
<i>macro
</i>(
<i>z
</i>,
<i>1</i>,
<i>data
</i>) ...
<i>macro
</i>(
<i>z
</i>,
<i>count
</i> -
<i>1</i>,
<i>data
</i>)
40 The
<i>z
</i> value that is passed to
<i>macro
</i> represents the next available repetition dimension.
41 Other macros that have
<b>_Z
</b> suffix variants internally use
<b>BOOST_PP_REPEAT
</b>--for example,
<b>BOOST_PP_ENUM_PARAMS
</b> and
<b>BOOST_PP_ENUM_PARAMS_Z
</b>.
42 Using these
<b>_Z
</b> versions is not strictly necessary, but passing the
<i>z
</i> value (that is passed to
<i>macro
</i>) to these macros allows them to reenter
<b>BOOST_PP_REPEAT
</b> with maximum efficiency.
45 To directly use this
<i>z
</i> value, rather than simply passing it to another macro, see
<b>BOOST_PP_REPEAT_
<i>z
</i></b>.
48 Previously, this macro could not be used recursively inside
<b>BOOST_PP_REPEAT
</b>.
49 This limitation no longer exists, as the library can automatically detect the next available repetition depth.
53 <li><a href=
"limit_repeat.html">BOOST_PP_LIMIT_REPEAT
</a></li>
54 <li><a href=
"repeat_z.html">BOOST_PP_REPEAT_
<i>z
</i></a></li>
58 <b>Header:
</b> <a href=
"../headers/repetition/repeat.html"><boost/preprocessor/repetition/repeat.hpp
></a>
62 #include
<<a href=
"../headers/repetition/repeat.html">boost/preprocessor/repetition/repeat.hpp
</a>>
64 #define DECL(z, n, text) text ## n = n;
66 <a href=
"repeat.html">BOOST_PP_REPEAT
</a>(
5, DECL, int x)
69 <div style=
"margin-left: 0px;">
70 <i>© Copyright
<a href=
"http://www.housemarque.com" target=
"_top">Housemarque Oy
</a> 2002</i>
71 </br><i>© Copyright Paul Mensonides
2002</i>
73 <div style=
"margin-left: 0px;">
74 <p><small>Distributed under the Boost Software License, Version
1.0. (See
75 accompanying file
<a href=
"../../../../LICENSE_1_0.txt">LICENSE_1_0.txt
</a> or
77 "http://www.boost.org/LICENSE_1_0.txt">www.boost.org/LICENSE_1_0.txt
</a>)
</small></p>