BOOST_PP_ENUM_SHIFTED マクロはコンマで区切られた、ずらされたリストを生成する。
Usage
BOOST_PP_ENUM_SHIFTED(count, macro, data)
Arguments
- count
-
macro を繰り返し呼び出す回数。
有効な値の範囲は 0 から BOOST_PP_LIMIT_REPEAT まで。
- macro
-
macro(z, n, data) の形の三項演算。
このマクロは、
利用可能な次の反復の深さ、
現在の繰り返し番号、
付属の data の三引数でもって BOOST_PP_ENUM_SHIFTED により展開される。
- data
-
macro に渡される付属データ。
Remarks
このマクロはコンマ区切りのシーケンスに展開される:
macro(z, 1, data), ... macro(z, count - 1, data)
macro に渡される z の値は、利用可能な次の反復の次元を表す。
接尾辞 _Z を持つ他のマクロの仲間、例えば BOOST_PP_ENUM_PARAMS に対しての BOOST_PP_ENUM_PARAMS_Z、
は内部で BOOST_PP_REPEAT を使っている。
これらの _Z バージョンを使う必要は厳密にはないが、z の値(これは macro に渡される)をこれらのマクロに渡すことで、
最も効率よく BOOST_PP_REPEAT に再入できる。
この z の値を単純に他のマクロに渡すのではなく、直接使うためには、BOOST_PP_ENUM_SHIFTED_z を見よ。
以前、このマクロは BOOST_PP_REPEAT の中で再帰的に使うことは出来なかった。
この制限はもう存在しない。ライブラリは自動的に実行可能な次の反復の深さを発見できるからだ。
See Also
Requirements
Sample Code
#include <boost/preprocessor/repetition/enum.hpp>
#include <boost/preprocessor/repetition/enum_shifted.hpp>
#define TYPE(z, n, type) type
BOOST_PP_ENUM(5, TYPE, int) // int, int, int, int, int に展開される
BOOST_PP_ENUM_SHIFTED(5, TYPE, int) // int, int, int, int に展開される