1 /*=========================================================================
4 Module: $RCSfile: gdcmDebug.h,v $
6 Date: $Date: 2005/10/26 14:50:30 $
7 Version: $Revision: 1.45 $
9 Copyright (c) CREATIS (Centre de Recherche et d'Applications en Traitement de
10 l'Image). All rights reserved. See Doc/License.txt or
11 http://www.creatis.insa-lyon.fr/Public/Gdcm/License.html for details.
13 This software is distributed WITHOUT ANY WARRANTY; without even
14 the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
15 PURPOSE. See the above copyright notices for more information.
17 =========================================================================*/
22 #include "gdcmCommon.h"
32 //-----------------------------------------------------------------------------
35 * \brief Debug is an object for debugging in program.
36 * It has 2 debugging modes :
37 * - error : for bad library use, seriously wrong DICOM
38 * - debug : for information/debug messages
39 * - warning : for warning about DICOM quality (kosher)
40 * - assert : design by contract implementation. A function should have
41 * proper input and proper output.
42 * (should not happen, not user controlled)
44 * A debugging message is only shown if the flag is on (DebugFlag)
45 * This is static var and can be set at beginning of code:
46 * gdcm::Debug::SetDebugOn();
48 class GDCM_EXPORT Debug
54 /// \brief This is a global flag that controls whether any debug, warning
55 /// messages are displayed.
56 static void SetDebugFlag (bool flag);
57 static bool GetDebugFlag ();
58 /// \brief Sets the Debug Flag to true
59 static void DebugOn () { SetDebugFlag(true); }
60 /// \brief Sets the Debug Flag to false
61 static void DebugOff () { SetDebugFlag(false); }
63 /// \brief This is a global flag that controls if debug are redirected
65 static void SetDebugToFile (bool flag);
66 static bool GetDebugToFile ();
67 /// \brief Next debug messages will be sent in the debug file
68 static void DebugToFileOn () { SetDebugToFile(true); }
69 /// \brief Next debug messages will be sent in the standard output
70 static void DebugToFileOff () { SetDebugToFile(false); }
72 static void SetDebugFilename (std::string const &filename);
74 static std::ofstream &GetDebugFile ();
77 } // end namespace gdcm
79 // Here we define function this is the only way to be able to pass
80 // stuff with indirection like:
81 // gdcmDebug( "my message:" << i << '\t' );
82 // You cannot use function unless you use vnsprintf ...
84 // __FUNCTION is not always defined by preprocessor
85 // In c++ we should use __PRETTY_FUNCTION__ instead...
86 #ifdef GDCM_COMPILER_HAS_FUNCTION
87 // Handle particular case for GNU C++ which also defines __PRETTY_FUNCTION__
88 // which is a lot nice in C++
90 # define __FUNCTION__ __FUNC__
93 # define GDCM_FUNCTION __PRETTY_FUNCTION__
95 # define GDCM_FUNCTION __FUNCTION__
98 # define GDCM_FUNCTION "<unknow>"
99 #endif //GDCM_COMPILER_HAS_FUNCTION
103 * @param msg message part
106 #define gdcmDebugMacro(msg) {}
108 #define gdcmDebugMacro(msg) \
110 if( Debug::GetDebugFlag() ) \
112 std::ostringstream osmacro; \
113 osmacro << "Debug: In " __FILE__ ", line " << __LINE__ \
114 << ", function " << GDCM_FUNCTION << '\n'; \
116 osmacro << "Last system error was: " << \
117 strerror(errno) << '\n'; \
118 osmacro << msg << "\n\n"; \
119 if( Debug::GetDebugToFile() ) \
120 Debug::GetDebugFile() << osmacro.str() << std::endl; \
122 std::cerr << osmacro.str() << std::endl; \
129 * @param msg message part
132 #define gdcmWarningMacro(msg) {}
134 #define gdcmWarningMacro(msg) \
136 if( Debug::GetDebugFlag() ) \
138 std::ostringstream osmacro; \
139 osmacro << "Warning: In " __FILE__ ", line " << __LINE__ \
140 << ", function " << GDCM_FUNCTION << "\n" \
142 if( Debug::GetDebugToFile() ) \
143 Debug::GetDebugFile() << osmacro.str() << std::endl; \
145 std::cerr << osmacro.str() << std::endl; \
152 * @param msg second message part
155 #define gdcmErrorMacro(msg) {}
157 #define gdcmErrorMacro(msg) \
159 std::ostringstream osmacro; \
160 osmacro << "Error: In " __FILE__ ", line " << __LINE__ \
161 << ", function " << GDCM_FUNCTION << '\n' \
163 if( Debug::GetDebugToFile() ) \
164 Debug::GetDebugFile() << osmacro.str() << std::endl; \
166 std::cerr << osmacro.str() << std::endl; \
172 * @param arg argument to test
173 * An easy solution to pass also a message is to do:
174 * gdcmAssertMacro( "my message" && 2 < 3 )
177 #define gdcmAssertMacro(arg) {}
179 #define gdcmAssertMacro(arg) \
183 std::ostringstream osmacro; \
184 osmacro << "Assert: In " __FILE__ ", line " << __LINE__ \
185 << ", function " << GDCM_FUNCTION \
187 if( Debug::GetDebugToFile() ) \
188 Debug::GetDebugFile() << osmacro.str() << std::endl; \
190 std::cerr << osmacro.str() << std::endl; \
196 //-----------------------------------------------------------------------------
198 // Define GDCM_LEGACY macro to mark legacy methods where they are
199 // declared in their class.
201 // WARNING : Don't try to use it with 'inline' methods !
205 // // @deprecated Replaced by MyOtherMethod() as of gdcm 2.0.
206 // GDCM_LEGACY(void MyMethod());
207 #if defined(GDCM_LEGACY_REMOVE)
208 // Remove legacy methods completely.
209 # define GDCM_LEGACY(method)
210 #elif defined(GDCM_LEGACY_SILENT) || defined(SWIG)
211 // Provide legacy methods with no warnings.
212 # define GDCM_LEGACY(method) method
214 // Setup compile-time warnings for uses of deprecated methods if
215 // possible on this compiler.
216 # if defined(__GNUC__) && !defined(__INTEL_COMPILER) && (__GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1))
217 #if defined(__APPLE__) && (__GNUC__ == 3) && (__GNUC_MINOR__ == 3)
218 // Seems like there is a bug in APPLE gcc for deprecated attribute and ctor
219 // This is fixed in g++ 4.0 (Tiger)
220 # define GDCM_LEGACY(method) method
222 # define GDCM_LEGACY(method) method __attribute__((deprecated))
224 # elif defined(_MSC_VER) && _MSC_VER >= 1300
225 # define GDCM_LEGACY(method) __declspec(deprecated) method
227 # define GDCM_LEGACY(method) method
231 // Macros to create runtime deprecation warning messages in function
232 // bodies. Example usage:
234 // void MyClass::MyOldMethod()
236 // GDCM_LEGACY_BODY(MyClass::MyOldMethod, 2.0);
239 // void MyClass::MyMethod()
241 // GDCM_LEGACY_REPLACED_BODY(MyClass::MyMethod, 5.0,
242 // MyClass::MyOtherMethod);
244 #if defined(GDCM_LEGACY_REMOVE) || defined(GDCM_LEGACY_SILENT)
245 # define GDCM_LEGACY_BODY(method, version)
246 # define GDCM_LEGACY_REPLACED_BODY(method, version, replace)
248 # define GDCM_LEGACY_BODY(method, version) \
249 gdcmWarningMacro(#method " was deprecated for gdcm" #version " and will be removed in a future version.")
250 # define GDCM_LEGACY_REPLACED_BODY(method, version, replace) \
251 gdcmWarningMacro(#method " was deprecated for gdcm" #version " and will be removed in a future version. Use " #replace " instead.")