Debugging, error processing

Defines
#define	XklDebug(level,...)   _XklDebug( __FILE__, __func__, level, __VA_ARGS__ )
Typedefs
typedef void(*)	XklLogAppender (const char file[], const char function[], int level, const char format[], va_list args)
Functions
const char *	XklGetLastError (void)
void	_XklDebug (const char file[], const char function[], int level, const char format[],...)
void	XklDefaultLogAppender (const char file[], const char function[], int level, const char format[], va_list args)
void	XklSetLogAppender (XklLogAppender fun)
void	XklSetDebugLevel (int level)

---

Define Documentation

#define XklDebug	(	level,
		...		)	_XklDebug( __FILE__, __func__, level, __VA_ARGS__ )

Output (optionally) some debug info

Parameters:

level

is a level of the message

See also:

_XklDebug

---

Typedef Documentation

typedef void( *) XklLogAppender(const char file[], const char function[], int level, const char format[], va_list args)

Custom log output method for _XklDebug. This appender is NOT called if the level of the message is greater than currently set debug level.

Parameters:

	file	is the name of the source file. Preprocessor symbol__FILE__ should be used here
	function	is a name of the function Preprocessor symbol__func__ should be used here
	level	is a level of the message
	format	is a format (like in printf)
	args	is the list of parameters

See also:

_XklDebug

XklSetDebugLevel

---

Function Documentation

void _XklDebug	(	const char	file[],
		const char	function[],
		int	level,
		const char	format[],
			...
	)

Output (optionally) some debug info

Parameters:

	file	is the name of the source file. Preprocessor symbol__FILE__ should be used here
	function	is a name of the function Preprocessor symbol__func__ should be used here
	level	is a level of the message
	format	is a format (like in printf)

See also:

XklDebug

void XklDefaultLogAppender	(	const char	file[],
		const char	function[],
		int	level,
		const char	format[],
		va_list	args
	)

Default log output method. Sends everything to stdout.

Parameters:

	file	is the name of the source file. Preprocessor symbol__FILE__ should be used here
	function	is a name of the function Preprocessor symbol__func__ should be used here
	level	is a level of the message
	format	is a format (like in printf)
	args	is the list of parameters

const char* XklGetLastError

(

void

)

Returns:

the text message (statically allocated) of the last error

void XklSetDebugLevel

(

int

level

)

Sets maximum debug level. Message of the level more than the one set here - will be ignored

Parameters:

level

is a new debug level

void XklSetLogAppender

(

XklLogAppender

fun

)

Installs the custom log appender.function

Parameters:

fun

is the new log appender

---