/* * Copyright (c) 2010-2019 Belledonne Communications SARL. * * This file is part of Liblinphone. * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation, either version 3 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program. If not, see . */ #ifndef _L_ENUM_GENERATOR_H_ #define _L_ENUM_GENERATOR_H_ #include "linphone/utils/magic-macros.h" // ============================================================================= LINPHONE_BEGIN_NAMESPACE // ----------------------------------------------------------------------------- // Low-level, do not call. // ----------------------------------------------------------------------------- // Declare one enum value. `value` is optional, it can be generated. // It's useful to force value in the case of mask. #define L_DECLARE_ENUM_VALUE_1_ARG(NAME) NAME, #define L_DECLARE_ENUM_VALUE_2_ARGS(NAME, VALUE) NAME = VALUE, // Call the right macro. (With or without value.) #define L_DECLARE_ENUM_MACRO_CHOOSER(...) \ L_EXPAND(L_GET_ARG_3(__VA_ARGS__, L_DECLARE_ENUM_VALUE_2_ARGS, L_DECLARE_ENUM_VALUE_1_ARG)) // Enum value declaration. #define L_DECLARE_ENUM_VALUE(...) \ L_EXPAND(L_DECLARE_ENUM_MACRO_CHOOSER(__VA_ARGS__)(__VA_ARGS__)) #ifdef __cplusplus // `getEnumValue` helper. #define L_DECLARE_ENUM_VALUE_STR_CASE(ENUM_NAME, VALUE_NAME, ...) \ case ENUM_NAME::VALUE_NAME: return #ENUM_NAME "::" #VALUE_NAME; // Helper to get enum name. #define L_DECLARE_ENUM_NAME(NAME, ...) NAME, // Get names as string from enum values. #define L_GET_ENUM_VALUE_NAMES(VALUES) L_GET_HEAP(VALUES(L_DECLARE_ENUM_NAME)) #endif // ----------------------------------------------------------------------------- // Public API. // ----------------------------------------------------------------------------- #ifdef __cplusplus #define L_DECLARE_ENUM(NAME, VALUES) \ enum class NAME { \ VALUES(L_DECLARE_ENUM_VALUE) \ }; \ friend constexpr const char *getEnumNameAsString (NAME) { \ return #NAME; \ } \ friend const char *getEnumValueAsString (const NAME &value) { \ switch (value) { \ L_APPLY_WITHOUT_COMMA(L_DECLARE_ENUM_VALUE_STR_CASE, NAME, L_GET_ENUM_VALUE_NAMES(VALUES)) \ } \ return ""; \ } //Explicit conversion from enum type to underlying type template constexpr auto to_integral(T e) -> typename std::underlying_type::type { return static_cast::type>(e); } #define L_GET_ENUM_VALUE(VALUE) to_integral(VALUE) #endif #define L_C_ENUM_PREFIX Linphone // TODO: This macro should be used but it is triggering a bug in doxygen that // has been fixed in the 1.8.8 version. See https://bugzilla.gnome.org/show_bug.cgi?id=731985 // Meanwhile use 2 different macros. #if 0 #define L_DECLARE_C_ENUM(NAME, VALUES) \ typedef enum L_CONCAT(_, L_CONCAT(L_C_ENUM_PREFIX, NAME)) { \ L_APPLY(L_CONCAT, L_CONCAT(L_C_ENUM_PREFIX, NAME), L_GET_HEAP(VALUES(L_DECLARE_ENUM_VALUE))) \ } L_CONCAT(L_C_ENUM_PREFIX, NAME) #else #define L_DECLARE_C_ENUM(NAME, VALUES) \ typedef enum L_CONCAT(_, L_CONCAT(L_C_ENUM_PREFIX, NAME)) { \ L_APPLY(L_CONCAT, L_CONCAT(L_C_ENUM_PREFIX, NAME), L_GET_HEAP(VALUES(L_DECLARE_ENUM_VALUE_1_ARG))) \ } L_CONCAT(L_C_ENUM_PREFIX, NAME) #define L_DECLARE_C_ENUM_FIXED_VALUES(NAME, VALUES) \ typedef enum L_CONCAT(_, L_CONCAT(L_C_ENUM_PREFIX, NAME)) { \ L_APPLY(L_CONCAT, L_CONCAT(L_C_ENUM_PREFIX, NAME), L_GET_HEAP(VALUES(L_DECLARE_ENUM_VALUE_2_ARGS))) \ } L_CONCAT(L_C_ENUM_PREFIX, NAME) #endif LINPHONE_END_NAMESPACE #endif // ifndef _L_ENUM_GENERATOR_H_