Path: blob/main/contrib/googletest/googlemock/include/gmock/internal/gmock-pp.h
48525 views
#ifndef GOOGLEMOCK_INCLUDE_GMOCK_INTERNAL_GMOCK_PP_H_1#define GOOGLEMOCK_INCLUDE_GMOCK_INTERNAL_GMOCK_PP_H_23// Expands and concatenates the arguments. Constructed macros reevaluate.4#define GMOCK_PP_CAT(_1, _2) GMOCK_PP_INTERNAL_CAT(_1, _2)56// Expands and stringifies the only argument.7#define GMOCK_PP_STRINGIZE(...) GMOCK_PP_INTERNAL_STRINGIZE(__VA_ARGS__)89// Returns empty. Given a variadic number of arguments.10#define GMOCK_PP_EMPTY(...)1112// Returns a comma. Given a variadic number of arguments.13#define GMOCK_PP_COMMA(...) ,1415// Returns the only argument.16#define GMOCK_PP_IDENTITY(_1) _11718// Evaluates to the number of arguments after expansion.19//20// #define PAIR x, y21//22// GMOCK_PP_NARG() => 123// GMOCK_PP_NARG(x) => 124// GMOCK_PP_NARG(x, y) => 225// GMOCK_PP_NARG(PAIR) => 226//27// Requires: the number of arguments after expansion is at most 15.28#define GMOCK_PP_NARG(...) \29GMOCK_PP_INTERNAL_16TH( \30(__VA_ARGS__, 15, 14, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0))3132// Returns 1 if the expansion of arguments has an unprotected comma. Otherwise33// returns 0. Requires no more than 15 unprotected commas.34#define GMOCK_PP_HAS_COMMA(...) \35GMOCK_PP_INTERNAL_16TH( \36(__VA_ARGS__, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0))3738// Returns the first argument.39#define GMOCK_PP_HEAD(...) GMOCK_PP_INTERNAL_HEAD((__VA_ARGS__, unusedArg))4041// Returns the tail. A variadic list of all arguments minus the first. Requires42// at least one argument.43#define GMOCK_PP_TAIL(...) GMOCK_PP_INTERNAL_TAIL((__VA_ARGS__))4445// Calls CAT(_Macro, NARG(__VA_ARGS__))(__VA_ARGS__)46#define GMOCK_PP_VARIADIC_CALL(_Macro, ...) \47GMOCK_PP_IDENTITY( \48GMOCK_PP_CAT(_Macro, GMOCK_PP_NARG(__VA_ARGS__))(__VA_ARGS__))4950// If the arguments after expansion have no tokens, evaluates to `1`. Otherwise51// evaluates to `0`.52//53// Requires: * the number of arguments after expansion is at most 15.54// * If the argument is a macro, it must be able to be called with one55// argument.56//57// Implementation details:58//59// There is one case when it generates a compile error: if the argument is macro60// that cannot be called with one argument.61//62// #define M(a, b) // it doesn't matter what it expands to63//64// // Expected: expands to `0`.65// // Actual: compile error.66// GMOCK_PP_IS_EMPTY(M)67//68// There are 4 cases tested:69//70// * __VA_ARGS__ possible expansion has no unparen'd commas. Expected 0.71// * __VA_ARGS__ possible expansion is not enclosed in parenthesis. Expected 0.72// * __VA_ARGS__ possible expansion is not a macro that ()-evaluates to a comma.73// Expected 074// * __VA_ARGS__ is empty, or has unparen'd commas, or is enclosed in75// parenthesis, or is a macro that ()-evaluates to comma. Expected 1.76//77// We trigger detection on '0001', i.e. on empty.78#define GMOCK_PP_IS_EMPTY(...) \79GMOCK_PP_INTERNAL_IS_EMPTY(GMOCK_PP_HAS_COMMA(__VA_ARGS__), \80GMOCK_PP_HAS_COMMA(GMOCK_PP_COMMA __VA_ARGS__), \81GMOCK_PP_HAS_COMMA(__VA_ARGS__()), \82GMOCK_PP_HAS_COMMA(GMOCK_PP_COMMA __VA_ARGS__()))8384// Evaluates to _Then if _Cond is 1 and _Else if _Cond is 0.85#define GMOCK_PP_IF(_Cond, _Then, _Else) \86GMOCK_PP_CAT(GMOCK_PP_INTERNAL_IF_, _Cond)(_Then, _Else)8788// Similar to GMOCK_PP_IF but takes _Then and _Else in parentheses.89//90// GMOCK_PP_GENERIC_IF(1, (a, b, c), (d, e, f)) => a, b, c91// GMOCK_PP_GENERIC_IF(0, (a, b, c), (d, e, f)) => d, e, f92//93#define GMOCK_PP_GENERIC_IF(_Cond, _Then, _Else) \94GMOCK_PP_REMOVE_PARENS(GMOCK_PP_IF(_Cond, _Then, _Else))9596// Evaluates to the number of arguments after expansion. Identifies 'empty' as97// 0.98//99// #define PAIR x, y100//101// GMOCK_PP_NARG0() => 0102// GMOCK_PP_NARG0(x) => 1103// GMOCK_PP_NARG0(x, y) => 2104// GMOCK_PP_NARG0(PAIR) => 2105//106// Requires: * the number of arguments after expansion is at most 15.107// * If the argument is a macro, it must be able to be called with one108// argument.109#define GMOCK_PP_NARG0(...) \110GMOCK_PP_IF(GMOCK_PP_IS_EMPTY(__VA_ARGS__), 0, GMOCK_PP_NARG(__VA_ARGS__))111112// Expands to 1 if the first argument starts with something in parentheses,113// otherwise to 0.114#define GMOCK_PP_IS_BEGIN_PARENS(...) \115GMOCK_PP_HEAD(GMOCK_PP_CAT(GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_R_, \116GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_C __VA_ARGS__))117118// Expands to 1 is there is only one argument and it is enclosed in parentheses.119#define GMOCK_PP_IS_ENCLOSED_PARENS(...) \120GMOCK_PP_IF(GMOCK_PP_IS_BEGIN_PARENS(__VA_ARGS__), \121GMOCK_PP_IS_EMPTY(GMOCK_PP_EMPTY __VA_ARGS__), 0)122123// Remove the parens, requires GMOCK_PP_IS_ENCLOSED_PARENS(args) => 1.124#define GMOCK_PP_REMOVE_PARENS(...) GMOCK_PP_INTERNAL_REMOVE_PARENS __VA_ARGS__125126// Expands to _Macro(0, _Data, e1) _Macro(1, _Data, e2) ... _Macro(K -1, _Data,127// eK) as many of GMOCK_INTERNAL_NARG0 _Tuple.128// Requires: * |_Macro| can be called with 3 arguments.129// * |_Tuple| expansion has no more than 15 elements.130#define GMOCK_PP_FOR_EACH(_Macro, _Data, _Tuple) \131GMOCK_PP_CAT(GMOCK_PP_INTERNAL_FOR_EACH_IMPL_, GMOCK_PP_NARG0 _Tuple) \132(0, _Macro, _Data, _Tuple)133134// Expands to _Macro(0, _Data, ) _Macro(1, _Data, ) ... _Macro(K - 1, _Data, )135// Empty if _K = 0.136// Requires: * |_Macro| can be called with 3 arguments.137// * |_K| literal between 0 and 15138#define GMOCK_PP_REPEAT(_Macro, _Data, _N) \139GMOCK_PP_CAT(GMOCK_PP_INTERNAL_FOR_EACH_IMPL_, _N) \140(0, _Macro, _Data, GMOCK_PP_INTENRAL_EMPTY_TUPLE)141142// Increments the argument, requires the argument to be between 0 and 15.143#define GMOCK_PP_INC(_i) GMOCK_PP_CAT(GMOCK_PP_INTERNAL_INC_, _i)144145// Returns comma if _i != 0. Requires _i to be between 0 and 15.146#define GMOCK_PP_COMMA_IF(_i) GMOCK_PP_CAT(GMOCK_PP_INTERNAL_COMMA_IF_, _i)147148// Internal details follow. Do not use any of these symbols outside of this149// file or we will break your code.150#define GMOCK_PP_INTENRAL_EMPTY_TUPLE (, , , , , , , , , , , , , , , )151#define GMOCK_PP_INTERNAL_CAT(_1, _2) _1##_2152#define GMOCK_PP_INTERNAL_STRINGIZE(...) #__VA_ARGS__153#define GMOCK_PP_INTERNAL_CAT_5(_1, _2, _3, _4, _5) _1##_2##_3##_4##_5154#define GMOCK_PP_INTERNAL_IS_EMPTY(_1, _2, _3, _4) \155GMOCK_PP_HAS_COMMA(GMOCK_PP_INTERNAL_CAT_5(GMOCK_PP_INTERNAL_IS_EMPTY_CASE_, \156_1, _2, _3, _4))157#define GMOCK_PP_INTERNAL_IS_EMPTY_CASE_0001 ,158#define GMOCK_PP_INTERNAL_IF_1(_Then, _Else) _Then159#define GMOCK_PP_INTERNAL_IF_0(_Then, _Else) _Else160161// Because of MSVC treating a token with a comma in it as a single token when162// passed to another macro, we need to force it to evaluate it as multiple163// tokens. We do that by using a "IDENTITY(MACRO PARENTHESIZED_ARGS)" macro. We164// define one per possible macro that relies on this behavior. Note "_Args" must165// be parenthesized.166#define GMOCK_PP_INTERNAL_INTERNAL_16TH(_1, _2, _3, _4, _5, _6, _7, _8, _9, \167_10, _11, _12, _13, _14, _15, _16, \168...) \169_16170#define GMOCK_PP_INTERNAL_16TH(_Args) \171GMOCK_PP_IDENTITY(GMOCK_PP_INTERNAL_INTERNAL_16TH _Args)172#define GMOCK_PP_INTERNAL_INTERNAL_HEAD(_1, ...) _1173#define GMOCK_PP_INTERNAL_HEAD(_Args) \174GMOCK_PP_IDENTITY(GMOCK_PP_INTERNAL_INTERNAL_HEAD _Args)175#define GMOCK_PP_INTERNAL_INTERNAL_TAIL(_1, ...) __VA_ARGS__176#define GMOCK_PP_INTERNAL_TAIL(_Args) \177GMOCK_PP_IDENTITY(GMOCK_PP_INTERNAL_INTERNAL_TAIL _Args)178179#define GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_C(...) 1 _180#define GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_R_1 1,181#define GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_R_GMOCK_PP_INTERNAL_IBP_IS_VARIADIC_C \1820,183#define GMOCK_PP_INTERNAL_REMOVE_PARENS(...) __VA_ARGS__184#define GMOCK_PP_INTERNAL_INC_0 1185#define GMOCK_PP_INTERNAL_INC_1 2186#define GMOCK_PP_INTERNAL_INC_2 3187#define GMOCK_PP_INTERNAL_INC_3 4188#define GMOCK_PP_INTERNAL_INC_4 5189#define GMOCK_PP_INTERNAL_INC_5 6190#define GMOCK_PP_INTERNAL_INC_6 7191#define GMOCK_PP_INTERNAL_INC_7 8192#define GMOCK_PP_INTERNAL_INC_8 9193#define GMOCK_PP_INTERNAL_INC_9 10194#define GMOCK_PP_INTERNAL_INC_10 11195#define GMOCK_PP_INTERNAL_INC_11 12196#define GMOCK_PP_INTERNAL_INC_12 13197#define GMOCK_PP_INTERNAL_INC_13 14198#define GMOCK_PP_INTERNAL_INC_14 15199#define GMOCK_PP_INTERNAL_INC_15 16200#define GMOCK_PP_INTERNAL_COMMA_IF_0201#define GMOCK_PP_INTERNAL_COMMA_IF_1 ,202#define GMOCK_PP_INTERNAL_COMMA_IF_2 ,203#define GMOCK_PP_INTERNAL_COMMA_IF_3 ,204#define GMOCK_PP_INTERNAL_COMMA_IF_4 ,205#define GMOCK_PP_INTERNAL_COMMA_IF_5 ,206#define GMOCK_PP_INTERNAL_COMMA_IF_6 ,207#define GMOCK_PP_INTERNAL_COMMA_IF_7 ,208#define GMOCK_PP_INTERNAL_COMMA_IF_8 ,209#define GMOCK_PP_INTERNAL_COMMA_IF_9 ,210#define GMOCK_PP_INTERNAL_COMMA_IF_10 ,211#define GMOCK_PP_INTERNAL_COMMA_IF_11 ,212#define GMOCK_PP_INTERNAL_COMMA_IF_12 ,213#define GMOCK_PP_INTERNAL_COMMA_IF_13 ,214#define GMOCK_PP_INTERNAL_COMMA_IF_14 ,215#define GMOCK_PP_INTERNAL_COMMA_IF_15 ,216#define GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, _element) \217_Macro(_i, _Data, _element)218#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_0(_i, _Macro, _Data, _Tuple)219#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_1(_i, _Macro, _Data, _Tuple) \220GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple)221#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_2(_i, _Macro, _Data, _Tuple) \222GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \223GMOCK_PP_INTERNAL_FOR_EACH_IMPL_1(GMOCK_PP_INC(_i), _Macro, _Data, \224(GMOCK_PP_TAIL _Tuple))225#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_3(_i, _Macro, _Data, _Tuple) \226GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \227GMOCK_PP_INTERNAL_FOR_EACH_IMPL_2(GMOCK_PP_INC(_i), _Macro, _Data, \228(GMOCK_PP_TAIL _Tuple))229#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_4(_i, _Macro, _Data, _Tuple) \230GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \231GMOCK_PP_INTERNAL_FOR_EACH_IMPL_3(GMOCK_PP_INC(_i), _Macro, _Data, \232(GMOCK_PP_TAIL _Tuple))233#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_5(_i, _Macro, _Data, _Tuple) \234GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \235GMOCK_PP_INTERNAL_FOR_EACH_IMPL_4(GMOCK_PP_INC(_i), _Macro, _Data, \236(GMOCK_PP_TAIL _Tuple))237#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_6(_i, _Macro, _Data, _Tuple) \238GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \239GMOCK_PP_INTERNAL_FOR_EACH_IMPL_5(GMOCK_PP_INC(_i), _Macro, _Data, \240(GMOCK_PP_TAIL _Tuple))241#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_7(_i, _Macro, _Data, _Tuple) \242GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \243GMOCK_PP_INTERNAL_FOR_EACH_IMPL_6(GMOCK_PP_INC(_i), _Macro, _Data, \244(GMOCK_PP_TAIL _Tuple))245#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_8(_i, _Macro, _Data, _Tuple) \246GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \247GMOCK_PP_INTERNAL_FOR_EACH_IMPL_7(GMOCK_PP_INC(_i), _Macro, _Data, \248(GMOCK_PP_TAIL _Tuple))249#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_9(_i, _Macro, _Data, _Tuple) \250GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \251GMOCK_PP_INTERNAL_FOR_EACH_IMPL_8(GMOCK_PP_INC(_i), _Macro, _Data, \252(GMOCK_PP_TAIL _Tuple))253#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_10(_i, _Macro, _Data, _Tuple) \254GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \255GMOCK_PP_INTERNAL_FOR_EACH_IMPL_9(GMOCK_PP_INC(_i), _Macro, _Data, \256(GMOCK_PP_TAIL _Tuple))257#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_11(_i, _Macro, _Data, _Tuple) \258GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \259GMOCK_PP_INTERNAL_FOR_EACH_IMPL_10(GMOCK_PP_INC(_i), _Macro, _Data, \260(GMOCK_PP_TAIL _Tuple))261#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_12(_i, _Macro, _Data, _Tuple) \262GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \263GMOCK_PP_INTERNAL_FOR_EACH_IMPL_11(GMOCK_PP_INC(_i), _Macro, _Data, \264(GMOCK_PP_TAIL _Tuple))265#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_13(_i, _Macro, _Data, _Tuple) \266GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \267GMOCK_PP_INTERNAL_FOR_EACH_IMPL_12(GMOCK_PP_INC(_i), _Macro, _Data, \268(GMOCK_PP_TAIL _Tuple))269#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_14(_i, _Macro, _Data, _Tuple) \270GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \271GMOCK_PP_INTERNAL_FOR_EACH_IMPL_13(GMOCK_PP_INC(_i), _Macro, _Data, \272(GMOCK_PP_TAIL _Tuple))273#define GMOCK_PP_INTERNAL_FOR_EACH_IMPL_15(_i, _Macro, _Data, _Tuple) \274GMOCK_PP_INTERNAL_CALL_MACRO(_Macro, _i, _Data, GMOCK_PP_HEAD _Tuple) \275GMOCK_PP_INTERNAL_FOR_EACH_IMPL_14(GMOCK_PP_INC(_i), _Macro, _Data, \276(GMOCK_PP_TAIL _Tuple))277278#endif // GOOGLEMOCK_INCLUDE_GMOCK_INTERNAL_GMOCK_PP_H_279280281