A collection of useful macros for manipulating the arguments. Useful for C99/C++11 codebase that needs a decent amount of preprocessing before compiling.
Just include MacroPowerToys.h from the root repository directory and enjoy the macros.
Alternatively, you can also include the individual header, listed for each macros.
- Appending / Concatenating items between two lists
- Counting the number of arguments
- Generate a list that counts up to the number
- Repeat the arguments with delimiter
- Get the last argument
- Check if arguments are empty or not
- Remove parenthesis
- Miscellaneous Macros (Concatenating, Composing)
- Macro Function Overloading
- Prefixing, Suffixing, Prepending or Appending to all arguments
- Persistent Counter
- __VA_OPT__ equivalent
- Split list with delimiter
AppendListsItems.hMPT_APPEND_LISTS_ITEMS( commaSeparatedList1, commaSeparatedList2 )
ConcatListsItems.hMPT_CONCAT_LISTS_ITEMS( commaSeparatedList1, commaSeparatedList2 )
//Appending lists items, up to 100 items
MPT_APPEND_LISTS_ITEMS( a1, a2, b1, b2 )
//Expands to...
a1 b1, a2 b2
//For example:
#define TYPES_LIST int, char, void*
#define NAMES _1, _2, _3
MPT_APPEND_LISTS_ITEMS( TYPES_LIST, NAMES )
//Expands to...
int _1, char _2, void* _3
//Similarly, to concatenate lists items, up to 100 items
MPT_CONCAT_LISTS_ITEMS( a1, a2, b1, b2 )
//Expands to...
a1b1, a2b2ArgsCount.hMPT_ARGS_COUNT( <arguments> )
//Count lists items, up to 100 items
MPT_ARGS_COUNT( a1, a2, a3, a4 )
//Expands to...
4CountTo.hMPT_COUNT_TO(number, prefix, suffix)MPT_COUNT_TO_MINUS_1(number, prefix, suffix)MPT_COUNT_TO_<Number>_(prefix, suffix)MPT_COUNT_TO_<Number>_MINUS_1(prefix, suffix)
MPT_COUNT_TO( 5, /* no prefix */, _suffix )
MPT_COUNT_TO_MINUS_1( 4, prefix_, /* no suffix */ )
MPT_COUNT_TO_5_( prefix_, /* no suffix */ )
MPT_COUNT_TO_3_MINUS_1( _, _ )
//Expands to...
1_suffix, 2_suffix, 3_suffix, 4_suffix, 5_suffix
prefix_1, prefix_2, prefix_3
prefix_1, prefix_2, prefix_3, prefix_4, prefix_5
_1_, _2_CountTo.hMPT_REPEAT(number, delimiter, <arguments>)MPT_REPEAT_WITH_COMMA(number, <arguments>)
MPT_REPEAT(3, , int)
MPT_REPEAT(2, |, 1, 2)
MPT_REPEAT_WITH_COMMA(3, a)
MPT_REPEAT_WITH_COMMA(2, a, b)
//Expands to...
int int int
1, 2 | 1, 2
a, a, a
a, b, a, bGetLastArg.hMPT_GET_LAST_ARG( <arguments> )
//Get the last argument in the list
MPT_GET_LAST_ARG( a1, a2, a3, a4 )
//Expands to...
a4AreArgsEmpty.hMPT_ARE_ARGS_EMPTY( <arguments> )
//Check if the list is empty
#define EMPTY_LIST
#define NOT_EMPTY_LIST 1, 2, 3
MPT_ARE_ARGS_EMPTY(EMPTY_LIST)
MPT_ARE_ARGS_EMPTY(NOT_EMPTY_LIST)
//Expands to...
EMPTY
NOT_EMPTYRemoveParenthesisInList.hMPT_REMOVE_PARENTHESIS( argument )- This removes any outer parenthesis for
argumentif there's any
- This removes any outer parenthesis for
MPT_REMOVE_PARENTHESIS_IN_LIST( <arguments> )- Same as
MPT_REMOVE_PARENTHESISbut does it for each item in the list
- Same as
MPT_REMOVE_PARENTHESIS( (ITEM_1) )
MPT_REMOVE_PARENTHESIS( (ITEM_1, ITEM_2) )
MPT_REMOVE_PARENTHESIS( ITEM_2 )
MPT_REMOVE_PARENTHESIS_IN_LIST( (ITEM_1), (ITEM_1, ITEM_2), ITEM_2 )
//Expands to...
ITEM_1
ITEM_1, ITEM_2
ITEM_2
ITEM_1, ITEM_1, ITEM_2, ITEM_2Miscellaneous.hMPT_CONCAT( a, b )- This has 20 copies for nested calling
MPT_CONCAT2( a, b ),MPT_CONCAT3( a, b ), etc...- This also has a delayed version for ability to not expand immediately
MPT_DELAYED_CONCAT( a, b ),MPT_DELAYED_CONCAT2( a, b ), etc...MPT_COMPOSE( a, b )- This has 20 copies for nested calling
MPT_COMPOSE2( a, b ),MPT_COMPOSE3( a, b ), etc...- This also has a delayed version for ability to not expand immediately
MPT_DELAYED_COMPOSE( a, b ),MPT_DELAYED_COMPOSE2( a, b ), etc...MPT_DELAY(...)- Delays the expansion of the arguments
MPT_CONCAT( ITEM_1, ITEM_2 )
MPT_COMPOSE( ITEM_1, ITEM_2 )
MPT_DELAY(ITEM_1, ITEM_2)
//Expands to...
ITEM_1ITEM_2
ITEM_1 ITEM_2
ITEM_1, ITEM_2Overload.hMPT_OVERLOAD_MACRO( macroName, <arguments> )
#define MACRO_FUNC_0() 0
#define MACRO_FUNC_1( a ) a
#define MACRO_FUNC_2( a, b ) a + b
//Using MPT_OVERLOAD_MACRO to allow MACRO_FUNC to be overloaded based on number of arguments
#define MACRO_FUNC( ... ) MPT_OVERLOAD_MACRO( MACRO_FUNC, __VA_ARGS__ )
MACRO_FUNC()
MACRO_FUNC(10)
MACRO_FUNC(1, 2)
//Expands to...
0 //MACRO_FUNC_0()
10 //MACRO_FUNC_1(10)
1 + 2 //MACRO_FUNC_2(1, 2)PrefixSuffixArgs.hMPT_PREFIX_SUFFIX_ARGS( prefix, suffix, <arguments> )
PrependAppendArgs.hMPT_PREPEND_APPEND_ARGS( prepend, append, <arguments> )
MPT_PREFIX_SUFFIX_ARGS( /* no prefix*/, _suffix, a1, a2, a3 )
MPT_PREPEND_APPEND_ARGS( const, /* no append */, int, char, char* )
//Expands to...
a1_suffix, a2_suffix, a3_suffix
const int, const char, const char*PersistentCounter.hMPT_START_COUNTER_AND_INCREMENT(name, [optional note])MPT_INCREMENT_COUNTER([optional note])MPT_GET_COUNT_AND_INCREMENT(name, [optional note])
//Given `__COUNTER__` is currently 0
MPT_START_COUNTER_AND_INCREMENT(MyCounter, /* any note here */);
MPT_INCREMENT_COUNTER(/* or no note at all */);
MPT_INCREMENT_COUNTER(2 /* or note to keep track of current __COUNTER__ */);
MPT_START_COUNTER_AND_INCREMENT(MyCounter2);
MPT_INCREMENT_COUNTER();
MPT_INCREMENT_COUNTER();
MPT_GET_COUNT_AND_INCREMENT(MyCounter);
MPT_GET_COUNT_AND_INCREMENT(MyCounter2);
//Expands to...
enum { MyCounter = 0 };
enum { INTERNAL_MPT1 = 1 };
enum { INTERNAL_MPT2 = 2 };
enum { MyCounter2 = 3 };
enum { INTERNAL_MPT4 = 4 };
enum { INTERNAL_MPT5 = 5 };
6 - MyCounter; //6
7 - MyCounter2; //4ArgsOpt.hMPT_ARGS_OPT( (<arguments>), (nonEmptyExpand) )
MPT_ARGS_OPT( (a), (a) ) 123
MPT_ARGS_OPT( (a,b), (a,b) ) 123
MPT_ARGS_OPT( (a,b), (,) ) 123
MPT_ARGS_OPT( (), (abc) ) 123
//Expands to...
a 123
a,b 123
, 123
123SplitList.hMPT_SPLIT_LIST( delimiter, <arguments> )
MPT_SPLIT_LIST( ;, int a, char b, float c );
//Expands to...
int a; char b; float c;