/* * general.h * Copyright (C) 2010-2017 Belledonne Communications SARL * * 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 2 * 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, write to the Free Software * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */ #ifndef _GENERAL_H_ #define _GENERAL_H_ #ifdef __cplusplus #include #endif // ============================================================================= #ifdef __cplusplus #define LINPHONE_BEGIN_NAMESPACE namespace LinphonePrivate { #define LINPHONE_END_NAMESPACE } #else #define LINPHONE_BEGIN_NAMESPACE #define LINPHONE_END_NAMESPACE #endif // ----------------------------------------------------------------------------- LINPHONE_BEGIN_NAMESPACE #ifndef LINPHONE_PUBLIC #if defined(_MSC_VER) #ifdef LINPHONE_STATIC #define LINPHONE_PUBLIC #else #ifdef LINPHONE_EXPORTS #define LINPHONE_PUBLIC __declspec(dllexport) #else #define LINPHONE_PUBLIC __declspec(dllimport) #endif #endif #else #define LINPHONE_PUBLIC #endif #endif #ifndef LINPHONE_DEPRECATED #if defined(_MSC_VER) #define LINPHONE_DEPRECATED __declspec(deprecated) #else #define LINPHONE_DEPRECATED __attribute__((deprecated)) #endif #endif // ----------------------------------------------------------------------------- #ifdef __cplusplus void l_assert (const char *condition, const char *file, int line); #ifndef DEBUG #define L_ASSERT(CONDITION) static_cast(false && (CONDITION)) #else #define L_ASSERT(CONDITION) ((CONDITION) ? static_cast(0) : LinphonePrivate::l_assert(#CONDITION, __FILE__, __LINE__)) #endif #ifndef _MSC_VER #define L_LIKELY(EXPRESSION) __builtin_expect(static_cast(EXPRESSION), true) #define L_UNLIKELY(EXPRESSION) __builtin_expect(static_cast(EXPRESSION), false) #else #define L_LIKELY(EXPRESSION) EXPRESSION #define L_UNLIKELY(EXPRESSION) EXPRESSION #endif class ClonableObject; class ClonableObjectPrivate; class Object; class ObjectPrivate; #define L_INTERNAL_DECLARE_PRIVATE(CLASS) \ inline CLASS ## Private *getPrivate() { \ return reinterpret_cast(mPrivate); \ } \ inline const CLASS ## Private *getPrivate() const { \ return reinterpret_cast(mPrivate); \ } \ friend class CLASS ## Private; \ friend class Wrapper; #define L_INTERNAL_DECLARE_PRIVATE_T(CLASS, PARENT_TYPE) \ inline CLASS ## Private *getPrivate() { \ return reinterpret_cast(PARENT_TYPE::mPrivate); \ } \ inline const CLASS ## Private *getPrivate() const { \ return reinterpret_cast(PARENT_TYPE::mPrivate); \ } \ friend class CLASS ## Private; \ friend class Wrapper; // Allows access to private internal data. // Gives a control to C Wrapper. #ifndef LINPHONE_TESTER #define L_DECLARE_PRIVATE(CLASS) L_INTERNAL_DECLARE_PRIVATE(CLASS) #define L_DECLARE_PRIVATE_T(CLASS, PARENT_TYPE) L_INTERNAL_DECLARE_PRIVATE_T(CLASS, PARENT_TYPE) #else #define L_DECLARE_PRIVATE(CLASS) \ L_INTERNAL_DECLARE_PRIVATE(CLASS) \ friend class Tester; #define L_DECLARE_PRIVATE_T(CLASS, PARENT_TYPE) \ L_INTERNAL_DECLARE_PRIVATE_T(CLASS, PARENT_TYPE) \ friend class Tester; #endif // Generic public helper. (Neither ClonableObject nor Object.) // `void *` is used to avoid downcasting. template constexpr T *getPublicHelper (void *object, const void *) { return static_cast(object); } template inline T *getPublicHelper (const U *map, const ClonableObjectPrivate *context) { auto it = map->find(context); L_ASSERT(it != map->end()); return static_cast(it->second); } template constexpr T *getPublicHelper (Object *object, const ObjectPrivate *) { return static_cast(object); } #define L_DECLARE_PUBLIC(CLASS) \ inline CLASS *getPublic () { \ L_ASSERT(mPublic); \ return getPublicHelper(mPublic, this); \ } \ inline const CLASS *getPublic () const { \ L_ASSERT(mPublic); \ return getPublicHelper(mPublic, this); \ } \ friend class CLASS; #define L_DISABLE_COPY(CLASS) \ CLASS (const CLASS &) = delete; \ CLASS &operator= (const CLASS &) = delete; // Get Private data. #define L_D() decltype(getPrivate()) const d = getPrivate(); // Get Public data. #define L_Q() decltype(getPublic()) const q = getPublic(); template struct AddConstMirror { typedef U type; }; template struct AddConstMirror { typedef typename std::add_const::type type; }; // Get Private data of class in a multiple inheritance case. #define L_D_T(CLASS, NAME) \ auto const NAME = static_cast< \ AddConstMirror< \ std::remove_reference::type, \ CLASS ## Private \ >::type * \ >(CLASS::mPrivate); // Get Private data of class in a multiple inheritance case. #define L_Q_T(CLASS, NAME) \ auto const NAME = static_cast< \ AddConstMirror< \ std::remove_reference::type, \ CLASS \ >::type * \ >(getPublic()); #define L_OVERRIDE_SHARED_FROM_THIS(CLASS) \ inline std::shared_ptr getSharedFromThis () { \ return std::static_pointer_cast(Object::getSharedFromThis()); \ } \ inline std::shared_ptr getSharedFromThis () const { \ return std::static_pointer_cast(Object::getSharedFromThis()); \ } #define L_USE_DEFAULT_SHARE_IMPL(CLASS, PARENT_CLASS) \ CLASS::CLASS (const CLASS &src) : PARENT_CLASS(*src.getPrivate()) {} \ CLASS &CLASS::operator= (const CLASS &src) { \ if (this != &src) \ setRef(*src.getPrivate()); \ return *this; \ } // ----------------------------------------------------------------------------- // Wrapper public. // ----------------------------------------------------------------------------- #define L_DECL_C_STRUCT(STRUCT) typedef struct _ ## STRUCT STRUCT; #define L_DECL_C_STRUCT_PREFIX_LESS(STRUCT) typedef struct STRUCT STRUCT; #endif LINPHONE_END_NAMESPACE #endif // ifndef _GENERAL_H_