1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
|
#ifndef _CLOG
#define _CLOG
/** \defgroup phidlog Phidget Logging
* Logging is provided mainly for debugging purposes. Enabling logging will output internal library
* information that can be used to find bugs with the help of Phidgetd Inc. Alternatively, the user
* can enable and write to the log for their own uses.
* @{
*/
typedef enum {
PHIDGET_LOG_CRITICAL = 1, /**< Really important errors that can't be recovered. Usually followed by an abort() */
PHIDGET_LOG_ERROR, /**< Errors that are recovered from. */
PHIDGET_LOG_WARNING, /**< Warning's about weird things that aren't neccesarily wrong. */
PHIDGET_LOG_DEBUG, /**< Should only be used during development - only shows up in the debug library. */
PHIDGET_LOG_INFO, /**< Info about the going on's in the library. */
PHIDGET_LOG_VERBOSE /**< Everything, including very common messages. */
} CPhidgetLog_level;
/**
* Enables logging.
* @param level The highest level of logging to output. All lower levels will also be output.
* @param outputFile File to output log to. This should be a full pathname, not a relative pathname. Specify NULL to output to stdout.
*/
PHIDGET21_API int CCONV CPhidget_enableLogging(CPhidgetLog_level level, const char *outputFile);
/**
* Disables logging.
*/
PHIDGET21_API int CCONV CPhidget_disableLogging();
/**
* Appends a message to the log.
* @param level The level at which to log the message.
* @param id An arbitrary identifier.
* @param message The message (printf style).
*/
PHIDGET21_API int CCONV CPhidget_log(CPhidgetLog_level level, const char *id, const char *message, ...);
#ifndef EXTERNALPROTO
#define LOG_TO_STDERR 0x8000
#define STRINGIFY(x) #x
#define TOSTRING(x) STRINGIFY(x)
#define LOG(level, ...) CPhidget_log(level, __FILE__ "(" TOSTRING(__LINE__) ")", __VA_ARGS__)
#define LOG_STDERR(level, ...) CPhidget_log(LOG_TO_STDERR|level, __FILE__ "(" TOSTRING(__LINE__) ")", __VA_ARGS__)
#endif
/** @} */
#endif
|
