JKQtPlotter/lib/jkqtcommon/jkqtcommon_imexport.h

109 lines
3.8 KiB
C++

#ifndef jkqtcommon_IMPORT_H
#define jkqtcommon_IMPORT_H
/*
Copyright (c) 2008-2020 Jan W. Krieger (<jan@jkrieger.de>)
last modification: $LastChangedDate: 2015-04-02 13:55:22 +0200 (Do, 02 Apr 2015) $ (revision $Rev: 3902 $)
This software is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License (LGPL) as published by
the Free Software Foundation, either version 2.1 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 Lesser General Public License (LGPL) for more details.
You should have received a copy of the GNU Lesser General Public License (LGPL)
along with this program. If not, see <http://www.gnu.org/licenses/>.
*/
/*! \def JKQTCOMMON_LIB_EXPORT
\ingroup tools
This define allows to export functions and classes from the jkqtcommon-library when building a dynamic/shared library.
Usage is as follows:
\code
#include "jkqtcommon/jkqtcommon_imexport.h"
class JKQTCOMMON_LIB_EXPORT exportedClassName {
...
};
JKQTCOMMON_LIB_EXPORT void exportedFunctionName();
\endcode
These macros append the appropriate \c __declspec(dllexport) and \c __declspec(dllimport)
to the function/class body and thus tell windows compilers to export these sysmbols from
the shared library, or import them from a shared library.
Note that these attributes are only necessary on windows systems!
These macros are controlled by two other macros:
- \c JKQTCOMMON_LIB_IN_DLL declares that the application should link against a shared version of
JKQTCommon, i.e. \c JKQTCommonSharedLib_XYZ .
This needs to be defined while compiling the library and while compiling
any application linking against \c JKQTCommonSharedLib_XYZ.
- \c JKQTCOMMON_LIB_EXPORT_LIBRARY is only defined while compiling JKQTCommon into \c JKQTCommonSharedLib_XYZ
and ensures thet the symbols are exported. If it is not defined (e.g. while
compiling an application), the symbols are imported
.
*/
/*! \def JKQTCOMMON_LIB_IN_DLL
\ingroup tools
\brief declares that the application should link against a shared version of
JKQTCommon, i.e. \c JKQTCommonSharedLib_XYZ .
This needs to be defined while compiling the library and while compiling
any application linking against \c JKQTCommonSharedLib_XYZ.
*/
/*! \def JKQTCOMMON_LIB_EXPORT_LIBRARY
\ingroup tools
\brief is only defined while compiling JKQTCommon into \c JKQTCommonSharedLib_XYZ
and ensures thet the symbols are exported. If it is not defined (e.g. while
compiling an application), the symbols are imported
*/
# ifndef __WINDOWS__
# if defined(WIN32) || defined(WIN64) || defined(_MSC_VER) || defined(_WIN32)
# define __WINDOWS__
# endif
# endif
#ifdef __WINDOWS__
# ifdef JKQTCOMMON_LIB_IN_DLL
# ifndef JKQTCOMMON_LIB_EXPORT
# ifdef JKQTCOMMON_LIB_EXPORT_LIBRARY
/* We are building this library */
# define JKQTCOMMON_LIB_EXPORT __declspec(dllexport)
# else
/* We are using this library */
# define JKQTCOMMON_LIB_EXPORT __declspec(dllimport)
# endif
# endif
# else
# ifndef JKQTCOMMON_LIB_EXPORT
# define JKQTCOMMON_LIB_EXPORT
# endif
# endif
#else
# define JKQTCOMMON_LIB_EXPORT
#endif
#endif // jkqtcommon_IMPORT_H