BOOST_PP_REPEAT_FROM_TO_1ST マクロは BOOST_PP_REPEAT_FROM_TO の第1の次元を表す。
Usage
BOOST_PP_REPEAT_FROM_TO_1ST(first, last, macro, data)
Arguments
-
first: 繰り返しの下限。 有効な値の範囲は0からBOOST_PP_LIMIT_MAGまでである。 -
last: 繰り返しの上限。 有効な値の範囲は0からBOOST_PP_LIMIT_MAGまでである。 -
macro:macro(z, n, data)という形の 3つ組の演算。 このマクロはBOOST_PP_REPEATによって、 利用可能な次の繰り返しの深さ、現在の繰り返し回数、付属のdataに展開される。 -
data:macroに渡される付属のデータ。
Remarks
このマクロは次のシーケンスに展開される:
macro(z, first, data) macro(z, first + 1, data) ... macro(z, last - 1, data)
繰り返しの回数 (つまり、 last - first は BOOST_PP_LIMIT_REPEAT を越えてはならない。
macro に渡される z の値は利用可能な次の繰り返し次元を表す。 _Z 接尾辞をもつ他のマクロとその仲間は内部で、BOOST_PP_REPEAT を利用している - 例えば、 BOOST_PP_ENUM_PARAMS と BOOST_PP_ENUM_PARAMS_Z などである。 これらの _Z バージョンを使うことは厳密には必要ではないが、(macro に渡される) z の値をこれらのマクロに渡すことで、最も効率的に BOOST_PP_REPEAT に再入することが出来る。
この z の値を、単純に別のマクロに渡すのではなく、直接使うためには、BOOST_PP_REPEAT_FROM_TO_z を見よ。
このマクロは推奨されていない。 過去のバージョンとの互換性のためだけに存在している。 代わりに BOOST_PP_REPEAT_FROM_TO を使うこと。
See Also
Requirements
Header: <boost/preprocessor/repetition/repeat_from_to.hpp>
Sample Code
#include <boost/preprocessor/repetition/repeat_from_to.hpp>
#define MACRO(z, n, data) (n)
BOOST_PP_REPEAT_FROM_TO_1ST(1, 6, MACRO, nil)
// expands to (1) (2) (3) (4) (5)