- Generated by
1.15.0
|
MeVisLab Toolbox Reference
|
Macros to print debug information. | |
Defines all ML debug, tracing, and error handling macros. Debug printing is controllable in and by the ML, and there are some constructs for selective debug printing. The required files are automatically included if using the standard ML include file mlModuleIncludes.h. The ML controls debug printing by the instance MLErrorOutput of the class ErrorOutput (from Project mlUtils). There, the configuration of debug outputs and the error handling system takes place. However, you should not use this instance or class directly. Better use the CoreControl module, which makes the important settings available (if that is possible by an, e.g., application like MeVisLab). There, debug printing can be enabled/disabled for the entire ML and debugging can be enabled/disabled for certain classes by the use of environment variables/debug symbols. The following macros are currently available to be inserted in program code:
Normally, each debug output is related to a debug symbol, which must be enabled in the ML before the debug information can be printed. Such a debug symbol can be defined as:
The third way, however, should only be used in modules dedicated for debug control or diagnostics and not in normal code. All debug macros are not compiled in release mode to improve performance and to reduce the amount of code generated. If debugging is enabled and the related debug symbol (or environment variable) for the macro is defined, then any of the debug macros will sent the
to the global instance MLErrorOutput of the ML. That instance then will sent this information to all registered instances, e.g., the modules MLConsole, MLLogFile, and application consoles in MeVisLab. | |
| #define | mlDebugConst(ENV_VAR, COUTS) |
| #define | mlDebug(COUTS) |
| #define | mlDebugConditional(COND_SYM, COUTS) |
| #define | mlDebugPrint(COUTS) |
| #define | mlDebugClass(CLASS_NAME, COUTS) |
Public macros to handle (fatal) errors, warnings, information, and trace log information. | |
| #define | ML_PRINT_FATAL_ERROR(FUNC_NAME, REASON, HANDLING) |
| #define | ML_PRINT_ERROR(FUNC_NAME, REASON, HANDLING) |
| #define | ML_PRINT_WARNING(FUNC_NAME, REASON, HANDLING) |
| #define | ML_PRINT_INFORMATION(FUNC_NAME, REASON, HANDLING) |
| #define | ML_PRINT_INFO(FUNC_NAME, HANDLING) |
Public macros for logging errors, warnings, and information messages. | |
Each of the macros returns an ostream, which allows to pipe additional details into the message. These macros are equivalent to the older ML_PRINT_* macros that only took a string for the message details. The error code is an optional second argument. If it is omitted, ML_BAD_PARAMETER is used. Example: if (outIndex<0) {
mlError("SomeClass::SomeMethod", ML_BAD_PARAMETER) << "returning NULL, excepted outIndex>=0, but got outIndex==" << outIndex;
}
if (outIndex>3) {
mlError("SomeClass::SomeMethod") << "returning NULL, excepted outIndex<=3, but got outIndex==" << outIndex;
}
| |
| #define | mlFatalError(FUNCTION, ...) |
| #define | mlError(FUNCTION, ...) |
| #define | mlWarning(FUNCTION, ...) |
| #define | mlInfo(FUNCTION) |
| #define | mlFatalErrorWithDump(FUNCTION, ERRORCODE, OBJECT) |
Logs a fatal error for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()). | |
| #define | mlErrorWithDump(FUNCTION, ERRORCODE, OBJECT) |
Logs an error for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()). | |
| #define | mlWarningWithDump(FUNCTION, ERRORCODE, OBJECT) |
Logs a warning for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()). | |
| #define | mlInfoWithDump(FUNCTION, OBJECT) |
Logs an informational message for FUNCTION and additionally dumps the given OBJECT (which needs to support getTypeId()). | |
Macros that can be used for logging of errors/warnings and information strings.
| #define ML_PRINT_ERROR | ( | FUNC_NAME, | |
| REASON, | |||
| HANDLING ) |
Like ML_PRINT_ERROR_DUMP(FUNC_NAME, REASON, HANDLING, RT_OBJ) without a runtime object to be dumped. Have a look at mlError for new style logging.
Definition at line 346 of file mlErrorMacros.h.
Referenced by __ML_KERNEL_CASE_CODE_clearAndHandleError(), ml::TVirtualVolume< DATATYPE >::_init(), ml::FiniteDifferenceFunctionWrapper::addInputBaseField(), ml::ITKTypedPointerWrapper< OBJ_TYPE, WRAPPER_CLASS_NAME >::addInputBaseField(), ml::FiniteDifferenceFunctionWrapper::addOutputBaseField(), ml::ITKTypedPointerWrapper< OBJ_TYPE, WRAPPER_CLASS_NAME >::addOutputBaseField(), ml::PCLSupportTools::appendFillPattern(), ml::PCLMLTools::appendSubImageVoxelsToPointCloud(), ml::PCLMLTools::createPointCloudFromBaseList(), ml::getInputAsItkImportImageAndSubImg(), ml::TKernel< KDATATYPE >::manipulateKernelElements(), ML_ITK_ML_PRINT_ERROR(), ml::PCLInventorTools::setMFVecFromPointCloud(), ml::setMLWorldFromITKScaleOriginAndOrientation(), and ml::ListTemplate< T >::setPersistentState().
| #define ML_PRINT_FATAL_ERROR | ( | FUNC_NAME, | |
| REASON, | |||
| HANDLING ) |
Like ML_PRINT_FATAL_ERROR_DUMP(FUNC_NAME, REASON, HANDLING, RT_OBJ) without a runtime object to be dumped. Have a look at mlFatalError for new style logging.
Definition at line 337 of file mlErrorMacros.h.
Referenced by ml::TKernel< KDATATYPE >::_addCoordinate(), ml::TKernel< KDATATYPE >::_calculateRealKernelExt(), ml::TVirtualVolume< DATATYPE >::_init(), ml::Engine::Engine(), ml::TKernel< KDATATYPE >::getSeparableDimIndex(), ml::CopyBase< BASE_DERIVED_CLASS >::handleNotification(), ml::ITKIndexFromMLVec6(), ml::ITKIndexFromMLVector(), ml::ITKSizeFromMLVector(), ml::MLTStdTypeInfos< VTYP >::MLTStdTypeInfos(), ml::KernelLineApplicatorBase< DATATYPE, KDATATYPE >::operator=(), ml::TKernel< KDATATYPE >::setKernel(), ml::TSubImage< DATATYPE >::TSubImage(), ml::TSubImage< DATATYPE >::TSubImage(), ml::TSubImage< DATATYPE >::TSubImage(), ml::tsubimage_cast(), ml::tsubimage_cast(), ml::tsubimage_cast(), and ml::tsubimage_cast().
| #define ML_PRINT_INFO | ( | FUNC_NAME, | |
| HANDLING ) |
Convenience version of ML_PRINT_INFORMATION(FUNC_NAME, REASON, HANDLING) with REASON = ML_RESULT_OK. Have a look at mlInfo for new style logging.
Definition at line 372 of file mlErrorMacros.h.
| #define ML_PRINT_INFORMATION | ( | FUNC_NAME, | |
| REASON, | |||
| HANDLING ) |
Like ML_PRINT_INFORMATION_DUMP(FUNC_NAME, REASON, HANDLING, RT_OBJ) without a runtime object to be dumped. Have a look at mlInfo for new style logging.
Definition at line 364 of file mlErrorMacros.h.
| #define ML_PRINT_WARNING | ( | FUNC_NAME, | |
| REASON, | |||
| HANDLING ) |
Like ML_PRINT_WARNING_DUMP(FUNC_NAME, REASON, HANDLING, RT_OBJ) without a runtime object to be dumped. Have a look at mlWarning for new style logging.
Definition at line 355 of file mlErrorMacros.h.
Referenced by ml::RasterFunction::_fillRaster(), ml::ITKMatrixFromMLMatrix(), ml::ITKPointSetFromBasePointer(), ml::ITKPolylineFromBasePointer(), ml::MLMatrixFromITKMatrix(), ml::MLVectorFromITKIndex(), and ml::MLVectorFromITKSize().
| #define mlDebug | ( | COUTS | ) |
This macro prints debug information given by COUTS. It requires that the class has the runtime type system implemented. This way, it accesses the type ID and creates the debug symbol by using 'ML_' + the class name. This is the normal macro used in implementations of ML modules. See header documentation for more information about debug printing.
| COUTS | The stream output redirected to the MLErrorOutput instance if the corresponding debug symbol is activated. |
| #define mlDebugClass | ( | CLASS_NAME, | |
| COUTS ) |
Macro for printing debug information. It requires that the class CLASS_NAME has the runtime type system implemented. This way, it accesses the type ID and creates a debug environment name. See header documentation for more information about debug printing.
| CLASS_NAME | The class type used to generate the debug symbol on which the output of COUTS is activated. |
| COUTS | The stream output sent to the error/debug output if the debug symbol created from CLASS_NAME is activated. |
| #define mlDebugConditional | ( | COND_SYM, | |
| COUTS ) |
Macro to specify subsets of debug outputs for a debug symbol which is given by the runtime type of the class.
It prints debug information in two different cases:
For example, if the following macro is used in the class "MyModule":
the debug information "Message1" is printed if the debug symbol "ML_MYMODULE" is defined or if the the debug symbol "ML_MYMODULE-CASES" is specified. If only "ML_MYMODULE-CASES" is specified, then only "Message1" is printed but nothing else from class MyModule.
This macro requires that the class in which it is used has the runtime type system implemented. This way, it accesses the type ID and creates a debug environment name from it. See header documentation for more information about debug printing.
| COND_SYM | specifies the additional symbol added to the class symbol (separated by a "-") |
| COUTS | The stream output sent to the error/debug output if the symbol given by the class name + "-" + COND_SYM is activated. |
| #define mlDebugConst | ( | ENV_VAR, | |
| COUTS ) |
Public macro to be used instead of print debug information. See header documentation of this file for full documentation.
| #define mlDebugPrint | ( | COUTS | ) |
Macro for printing debug information. It uses the ML_DEBUG_ENV_VAR as name of the class to be debugged. ML_DEBUG_ENV_VAR is required to be defined. Useful for classes that do not have a runtime interface. See header documentation for more information about debug printing.
| COUTS | The stream output sent to the error/debug output if the symbol defined in ML_DEBUG_ENV_NAME is activated. |
| #define mlError | ( | FUNCTION, | |
| ... ) |
Logs an error for FUNCTION with optional MLErrorCode. If MLErrorCode is omitted, ML_BAD_PARAMETER is used.
Definition at line 52 of file mlLogging.h.
Referenced by ml::TypedComputeClusters::process().
| #define mlErrorWithDump | ( | FUNCTION, | |
| ERRORCODE, | |||
| OBJECT ) |
Logs an error for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()).
Definition at line 71 of file mlLogging.h.
| #define mlFatalError | ( | FUNCTION, | |
| ... ) |
Logs a fatal error for FUNCTION with optional MLErrorCode. If MLErrorCode is omitted, ML_BAD_PARAMETER is used.
Definition at line 47 of file mlLogging.h.
| #define mlFatalErrorWithDump | ( | FUNCTION, | |
| ERRORCODE, | |||
| OBJECT ) |
Logs a fatal error for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()).
Definition at line 67 of file mlLogging.h.
| #define mlInfo | ( | FUNCTION | ) |
Logs an informational message.
Definition at line 62 of file mlLogging.h.
| #define mlInfoWithDump | ( | FUNCTION, | |
| OBJECT ) |
Logs an informational message for FUNCTION and additionally dumps the given OBJECT (which needs to support getTypeId()).
Definition at line 79 of file mlLogging.h.
| #define mlWarning | ( | FUNCTION, | |
| ... ) |
Logs a warning for FUNCTION with optional MLErrorCode. If MLErrorCode is omitted, ML_BAD_PARAMETER is used.
Definition at line 57 of file mlLogging.h.
| #define mlWarningWithDump | ( | FUNCTION, | |
| ERRORCODE, | |||
| OBJECT ) |
Logs a warning for FUNCTION with MLErrorCode ERRORCODE and additionally dumps the given OBJECT (which needs to support getTypeId()).
Definition at line 75 of file mlLogging.h.
1.15.0