2019-05-22 20:15:35 +00:00
|
|
|
/*
|
2020-07-20 16:35:17 +00:00
|
|
|
* Copyright (c) Facebook, Inc. and its affiliates.
|
2019-05-22 20:15:35 +00:00
|
|
|
*
|
|
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
|
|
* you may not use this file except in compliance with the License.
|
|
|
|
* You may obtain a copy of the License at
|
|
|
|
*
|
2020-07-20 16:35:17 +00:00
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
2019-05-22 20:15:35 +00:00
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
// @author: Andrei Alexandrescu
|
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
2020-07-20 16:35:17 +00:00
|
|
|
#include <folly/CPortability.h>
|
|
|
|
|
2019-05-22 20:15:35 +00:00
|
|
|
/**
|
|
|
|
* Necessarily evil preprocessor-related amenities.
|
|
|
|
*/
|
|
|
|
|
|
|
|
// MSVC's preprocessor is a pain, so we have to
|
|
|
|
// forcefully expand the VA args in some places.
|
|
|
|
#define FB_VA_GLUE(a, b) a b
|
|
|
|
|
|
|
|
/**
|
|
|
|
* FB_ONE_OR_NONE(hello, world) expands to hello and
|
|
|
|
* FB_ONE_OR_NONE(hello) expands to nothing. This macro is used to
|
|
|
|
* insert or eliminate text based on the presence of another argument.
|
|
|
|
*/
|
|
|
|
#define FB_ONE_OR_NONE(a, ...) FB_VA_GLUE(FB_THIRD, (a, ##__VA_ARGS__, a))
|
|
|
|
#define FB_THIRD(a, b, ...) __VA_ARGS__
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper macro that extracts the first argument out of a list of any
|
|
|
|
* number of arguments.
|
|
|
|
*/
|
|
|
|
#define FB_ARG_1(a, ...) a
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper macro that extracts the second argument out of a list of any
|
|
|
|
* number of arguments. If only one argument is given, it returns
|
|
|
|
* that.
|
|
|
|
*/
|
|
|
|
#ifdef _MSC_VER
|
|
|
|
// GCC refuses to expand this correctly if this macro itself was
|
|
|
|
// called with FB_VA_GLUE :(
|
|
|
|
#define FB_ARG_2_OR_1(...) \
|
|
|
|
FB_VA_GLUE(FB_ARG_2_OR_1_IMPL, (__VA_ARGS__, __VA_ARGS__))
|
|
|
|
#else
|
|
|
|
#define FB_ARG_2_OR_1(...) FB_ARG_2_OR_1_IMPL(__VA_ARGS__, __VA_ARGS__)
|
|
|
|
#endif
|
|
|
|
// Support macro for the above
|
|
|
|
#define FB_ARG_2_OR_1_IMPL(a, b, ...) b
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper macro that provides a way to pass argument with commas in it to
|
|
|
|
* some other macro whose syntax doesn't allow using extra parentheses.
|
|
|
|
* Example:
|
|
|
|
*
|
|
|
|
* #define MACRO(type, name) type name
|
|
|
|
* MACRO(FB_SINGLE_ARG(std::pair<size_t, size_t>), x);
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
#define FB_SINGLE_ARG(...) __VA_ARGS__
|
|
|
|
|
|
|
|
#define FOLLY_PP_DETAIL_APPEND_VA_ARG(...) , ##__VA_ARGS__
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper macro that just ignores its parameters.
|
|
|
|
*/
|
|
|
|
#define FOLLY_IGNORE(...)
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Helper macro that just ignores its parameters and inserts a semicolon.
|
|
|
|
*/
|
|
|
|
#define FOLLY_SEMICOLON(...) ;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* FB_ANONYMOUS_VARIABLE(str) introduces an identifier starting with
|
|
|
|
* str and ending with a number that varies with the line.
|
|
|
|
*/
|
|
|
|
#ifndef FB_ANONYMOUS_VARIABLE
|
|
|
|
#define FB_CONCATENATE_IMPL(s1, s2) s1##s2
|
|
|
|
#define FB_CONCATENATE(s1, s2) FB_CONCATENATE_IMPL(s1, s2)
|
|
|
|
#ifdef __COUNTER__
|
2020-07-20 16:35:17 +00:00
|
|
|
// Modular builds build each module with its own preprocessor state, meaning
|
|
|
|
// `__COUNTER__` no longer provides a unique number across a TU. Instead of
|
|
|
|
// calling back to just `__LINE__`, use a mix of `__COUNTER__` and `__LINE__`
|
|
|
|
// to try provide as much uniqueness as possible.
|
|
|
|
#if FOLLY_HAS_FEATURE(modules)
|
|
|
|
#define FB_ANONYMOUS_VARIABLE(str) \
|
|
|
|
FB_CONCATENATE(FB_CONCATENATE(FB_CONCATENATE(str, __COUNTER__), _), __LINE__)
|
|
|
|
#else
|
2019-05-22 20:15:35 +00:00
|
|
|
#define FB_ANONYMOUS_VARIABLE(str) FB_CONCATENATE(str, __COUNTER__)
|
2020-07-20 16:35:17 +00:00
|
|
|
#endif
|
2019-05-22 20:15:35 +00:00
|
|
|
#else
|
|
|
|
#define FB_ANONYMOUS_VARIABLE(str) FB_CONCATENATE(str, __LINE__)
|
|
|
|
#endif
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/**
|
2020-07-20 16:35:17 +00:00
|
|
|
* Use FOLLY_PP_STRINGIZE(x) when you'd want to do what #x does inside
|
2019-05-22 20:15:35 +00:00
|
|
|
* another macro expansion.
|
|
|
|
*/
|
2020-07-20 16:35:17 +00:00
|
|
|
#define FOLLY_PP_STRINGIZE(x) #x
|
2019-05-22 20:15:35 +00:00
|
|
|
|
|
|
|
#define FOLLY_PP_DETAIL_NARGS_1(dummy, _7, _6, _5, _4, _3, _2, _1, _0, ...) _0
|
|
|
|
#define FOLLY_PP_DETAIL_NARGS(...) \
|
|
|
|
FOLLY_PP_DETAIL_NARGS_1(dummy, ##__VA_ARGS__, 7, 6, 5, 4, 3, 2, 1, 0)
|
|
|
|
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_0(fn, ...)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_1(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_0(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_2(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_1(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_3(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_2(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_4(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_3(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_5(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_4(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_6(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_5(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_REC_7(fn, a, ...) \
|
|
|
|
fn(a) FOLLY_PP_DETAIL_FOR_EACH_REC_6(fn, __VA_ARGS__)
|
|
|
|
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_2(fn, n, ...) \
|
|
|
|
FOLLY_PP_DETAIL_FOR_EACH_REC_##n(fn, __VA_ARGS__)
|
|
|
|
#define FOLLY_PP_DETAIL_FOR_EACH_1(fn, n, ...) \
|
|
|
|
FOLLY_PP_DETAIL_FOR_EACH_2(fn, n, __VA_ARGS__)
|
|
|
|
|
|
|
|
/**
|
|
|
|
* FOLLY_PP_FOR_EACH
|
|
|
|
*
|
|
|
|
* Used to invoke a preprocessor macro, the name of which is passed as the
|
|
|
|
* first argument, once for each subsequent variadic argument.
|
|
|
|
*
|
|
|
|
* At present, supports [0, 8) arguments.
|
|
|
|
*
|
|
|
|
* This input:
|
|
|
|
*
|
|
|
|
* #define DOIT(a) go_do_it(a);
|
|
|
|
* FOLLY_PP_FOR_EACH(DOIT, 3, 5, 7)
|
|
|
|
* #undef DOIT
|
|
|
|
*
|
|
|
|
* Expands to this output (with whitespace adjusted for clarity):
|
|
|
|
*
|
|
|
|
* go_do_it(3);
|
|
|
|
* go_do_it(5);
|
|
|
|
* go_do_it(7);
|
|
|
|
*/
|
|
|
|
#define FOLLY_PP_FOR_EACH(fn, ...) \
|
|
|
|
FOLLY_PP_DETAIL_FOR_EACH_1( \
|
|
|
|
fn, FOLLY_PP_DETAIL_NARGS(__VA_ARGS__), __VA_ARGS__)
|