|  |  |  | Orc Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
enum OrcDebugLevel; void (*OrcDebugPrintFunc) (int level,const char *file,const char *func,int line,const char *format,va_list varargs); #define ORC_DEBUG_PRINT (level, ...) #define ORC_ERROR (...) #define ORC_WARNING (...) #define ORC_INFO (...) #define ORC_DEBUG (...) #define ORC_LOG (...) #define ORC_FUNCTION int orc_debug_get_level (void); void orc_debug_print (int level,const char *file,const char *func,int line,const char *format,...); void orc_debug_set_level (int level); void orc_debug_set_print_function (OrcDebugPrintFunc func);
typedef enum {
  ORC_DEBUG_NONE = 0,
  ORC_DEBUG_ERROR,
  ORC_DEBUG_WARNING,
  ORC_DEBUG_INFO,
  ORC_DEBUG_DEBUG,
  ORC_DEBUG_LOG
} OrcDebugLevel;
Enumeration describing debug levels in Orc.
| No debugging. Used to disable debugging output. | |
| The level for messages indicating that an error has occurred that causes Orc to produce incorrect results. Also used temporarily by developers for testing code. | |
| Messages at this level indicate something has occurred that a developer looking into an application problem may want to know. | |
| Messages at this level provide high-level information about Orc internals. | |
| The default level for logging messages. | |
| The level for messages that probably don't need to be logged at all. | 
void (*OrcDebugPrintFunc) (int level,const char *file,const char *func,int line,const char *format,va_list varargs);
Typedef describing functions that can be registered using
orc_debug_set_print_function() so that it is called to
print debugging messages.
| 
 | the debug level | 
| 
 | name of the file where the debug message occurs | 
| 
 | name of the function where the debug message occurs | 
| 
 | line in the file where the debug message occurs | 
| 
 | a printf format | 
| 
 | varargs for the printf format | 
#define ORC_DEBUG_PRINT(level, ...)
Macro to call orc_debug_print() with the correct values for
the name of the source file, line of source file, and function.
| 
 | debug level of message | 
#define ORC_ERROR(...) ORC_DEBUG_PRINT(ORC_DEBUG_ERROR, __VA_ARGS__)
Macro to call ORC_DEBUG_PRINT() with a level of ORC_DEBUG_ERROR.
| 
 | printf-style format and arguments | 
#define ORC_WARNING(...) ORC_DEBUG_PRINT(ORC_DEBUG_WARNING, __VA_ARGS__)
Macro to call ORC_DEBUG_PRINT() with a level of ORC_DEBUG_WARNING.
| 
 | printf-style format and arguments | 
#define ORC_INFO(...) ORC_DEBUG_PRINT(ORC_DEBUG_INFO, __VA_ARGS__)
Macro to call ORC_DEBUG_PRINT() with a level of ORC_DEBUG_INFO.
| 
 | printf-style format and arguments | 
#define ORC_DEBUG(...) ORC_DEBUG_PRINT(ORC_DEBUG_DEBUG, __VA_ARGS__)
Macro to call ORC_DEBUG_PRINT() with a level of ORC_DEBUG_DEBUG.
| 
 | printf-style format and arguments | 
#define ORC_LOG(...) ORC_DEBUG_PRINT(ORC_DEBUG_LOG, __VA_ARGS__)
Macro to call ORC_DEBUG_PRINT() with a level of ORC_DEBUG_LOG.
| 
 | printf-style format and arguments | 
#define ORC_FUNCTION __PRETTY_FUNCTION__
Internal macro that points to __PRETTY_FUNCTION__ or __func__ if the former is not available.
int                 orc_debug_get_level                 (void);
Gets the current debug level.
| Returns : | the current debug level | 
void orc_debug_print (int level,const char *file,const char *func,int line,const char *format,...);
void                orc_debug_set_level                 (int level);
Sets the current debug level.
| 
 | the new debug level | 
void                orc_debug_set_print_function        (OrcDebugPrintFunc func);
Sets the function to call when outputting debugging information.
A value of NULL for func will restore the default handler,
which prints debugging information to stderr.
| 
 | the function to call |