1 /*=========================================================================
4 Module: $RCSfile: gdcmDebug.h,v $
6 Date: $Date: 2005/10/26 14:47:06 $
7 Version: $Revision: 1.44 $
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' << msg << "\n\n"; \
118 if( Debug::GetDebugToFile() ) \
119 Debug::GetDebugFile() << osmacro.str() << std::endl; \
121 std::cerr << osmacro.str() << std::endl; \
128 * @param msg message part
131 #define gdcmWarningMacro(msg) {}
133 #define gdcmWarningMacro(msg) \
135 if( Debug::GetDebugFlag() ) \
137 std::ostringstream osmacro; \
138 osmacro << "Warning: In " __FILE__ ", line " << __LINE__ \
139 << ", function " << GDCM_FUNCTION << "\n" \
141 if( Debug::GetDebugToFile() ) \
142 Debug::GetDebugFile() << osmacro.str() << std::endl; \
144 std::cerr << osmacro.str() << std::endl; \
151 * @param msg second message part
154 #define gdcmErrorMacro(msg) {}
156 #define gdcmErrorMacro(msg) \
158 std::ostringstream osmacro; \
159 osmacro << "Error: In " __FILE__ ", line " << __LINE__ \
160 << ", function " << GDCM_FUNCTION << '\n' \
162 if( Debug::GetDebugToFile() ) \
163 Debug::GetDebugFile() << osmacro.str() << std::endl; \
165 std::cerr << osmacro.str() << std::endl; \
171 * @param arg argument to test
172 * An easy solution to pass also a message is to do:
173 * gdcmAssertMacro( "my message" && 2 < 3 )
176 #define gdcmAssertMacro(arg) {}
178 #define gdcmAssertMacro(arg) \
182 std::ostringstream osmacro; \
183 osmacro << "Assert: In " __FILE__ ", line " << __LINE__ \
184 << ", function " << GDCM_FUNCTION \
186 if( Debug::GetDebugToFile() ) \
187 Debug::GetDebugFile() << osmacro.str() << std::endl; \
189 std::cerr << osmacro.str() << std::endl; \
195 //-----------------------------------------------------------------------------
197 // Define GDCM_LEGACY macro to mark legacy methods where they are
198 // declared in their class.
200 // WARNING : Don't try to use it with 'inline' methods !
204 // // @deprecated Replaced by MyOtherMethod() as of gdcm 2.0.
205 // GDCM_LEGACY(void MyMethod());
206 #if defined(GDCM_LEGACY_REMOVE)
207 // Remove legacy methods completely.
208 # define GDCM_LEGACY(method)
209 #elif defined(GDCM_LEGACY_SILENT) || defined(SWIG)
210 // Provide legacy methods with no warnings.
211 # define GDCM_LEGACY(method) method
213 // Setup compile-time warnings for uses of deprecated methods if
214 // possible on this compiler.
215 # if defined(__GNUC__) && !defined(__INTEL_COMPILER) && (__GNUC__ > 3 || (__GNUC__ == 3 && __GNUC_MINOR__ >= 1))
216 #if defined(__APPLE__) && (__GNUC__ == 3) && (__GNUC_MINOR__ == 3)
217 // Seems like there is a bug in APPLE gcc for deprecated attribute and ctor
218 // This is fixed in g++ 4.0 (Tiger)
219 # define GDCM_LEGACY(method) method
221 # define GDCM_LEGACY(method) method __attribute__((deprecated))
223 # elif defined(_MSC_VER) && _MSC_VER >= 1300
224 # define GDCM_LEGACY(method) __declspec(deprecated) method
226 # define GDCM_LEGACY(method) method
230 // Macros to create runtime deprecation warning messages in function
231 // bodies. Example usage:
233 // void MyClass::MyOldMethod()
235 // GDCM_LEGACY_BODY(MyClass::MyOldMethod, 2.0);
238 // void MyClass::MyMethod()
240 // GDCM_LEGACY_REPLACED_BODY(MyClass::MyMethod, 5.0,
241 // MyClass::MyOtherMethod);
243 #if defined(GDCM_LEGACY_REMOVE) || defined(GDCM_LEGACY_SILENT)
244 # define GDCM_LEGACY_BODY(method, version)
245 # define GDCM_LEGACY_REPLACED_BODY(method, version, replace)
247 # define GDCM_LEGACY_BODY(method, version) \
248 gdcmWarningMacro(#method " was deprecated for gdcm" #version " and will be removed in a future version.")
249 # define GDCM_LEGACY_REPLACED_BODY(method, version, replace) \
250 gdcmWarningMacro(#method " was deprecated for gdcm" #version " and will be removed in a future version. Use " #replace " instead.")