Debug message generators

Classes
class	kdbgstream
class	kndbgstream

Macros
#define	k_funcinfo   "[" << __FILE__ << ":" << __LINE__ << "] "
#define	k_lineinfo   "[" << __FILE__ << ":" << __LINE__ << "] "

Typedefs
typedef kdbgstream &(*	KDBGFUNC) (kdbgstream &)
typedef kndbgstream &(*	KNDBGFUNC) (kndbgstream &)

Functions
kdbgstream &	perror (kdbgstream &s)
kndbgstream &	endl (kndbgstream &s)
kndbgstream &	flush (kndbgstream &s)
kndbgstream &	perror (kndbgstream &s)
kdbgstream	kdDebug (bool cond, int area=0)
kndbgstream	kndDebug (int area=0)
kndbgstream	kndDebug (bool, int=0)
kdbgstream	kdWarning (bool cond, int area=0)
kdbgstream	kdError (bool cond, int area=0)
kdbgstream	kdFatal (bool cond, int area=0)
template<class T >
kdbgstream &	kdbgstream::operator<< (const TQValueList< T > &list)
kdbgstream &	endl (kdbgstream &s)
kdbgstream &	flush (kdbgstream &s)
kdbgstream	kdDebug (int area=0)
TQString	kdBacktrace (int levels=-1)
void	kdBacktraceFD (int fd=2)
kdbgstream	kdWarning (int area=0)
kdbgstream	kdError (int area=0)
kdbgstream	kdFatal (int area=0)
void	kdClearDebugConfig ()

Detailed Description

KDE debug message streams let you and the user control just how many debug messages you see.

Macro Definition Documentation

k_funcinfo

#define k_funcinfo   "[" << __FILE__ << ":" << __LINE__ << "] "

Definition at line 61 of file kdebug.h.

k_lineinfo

#define k_lineinfo   "[" << __FILE__ << ":" << __LINE__ << "] "

Definition at line 64 of file kdebug.h.

Typedef Documentation

KDBGFUNC

typedef kdbgstream &(* KDBGFUNC) (kdbgstream &)

Definition at line 55 of file kdebug.h.

KNDBGFUNC

typedef kndbgstream &(* KNDBGFUNC) (kndbgstream &)

Definition at line 56 of file kdebug.h.

Function Documentation

endl() [1/2]

kdbgstream & endl ( kdbgstream &  s )

related

Prints an "\n".

Parameters

s	the debug stream to write to

Returns

the debug stream (s)

Definition at line 430 of file kdebug.h.

endl() [2/2]

kndbgstream & endl ( kndbgstream &  s )

inline

Does nothing.

Parameters

s

a stream

Returns

the given s

Definition at line 583 of file kdebug.h.

flush() [1/2]

kdbgstream & flush ( kdbgstream &  s )

related

Flushes the stream.

Parameters

s	the debug stream to write to

Returns

the debug stream (s)

Definition at line 438 of file kdebug.h.

flush() [2/2]

kndbgstream & flush ( kndbgstream &  s )

inline

Does nothing.

Parameters

s

a stream

Returns

the given s

Definition at line 589 of file kdebug.h.

kdBacktrace()

TQString kdBacktrace ( int  levels = -1 )

related

Returns a backtrace.

Parameters

levels

the number of levels of the backtrace. Defaults to -1 (as much as available).

Returns

a backtrace

Since

3.1

Definition at line 805 of file kdebug.cpp.

kdBacktraceFD()

void kdBacktraceFD ( int  fd = 2 )

related

Writes a backtrace to the given file descriptor.

In contrast to kdBacktrace, this function doesn't call any malloc(). So it supposed to be used in situations in which any extra memory allocation may lead to yet another crash. As a limitation it doesn't produce any symbol demangling.

Parameters

fd	a file descriptor to write to. Defaults to 2 (stderr)

Since

14.0

Definition at line 846 of file kdebug.cpp.

kdClearDebugConfig()

void kdClearDebugConfig ( )

related

Deletes the kdebugrc cache and therefore forces KDebug to reread the config file.

Definition at line 857 of file kdebug.cpp.

kdDebug() [1/2]

kdbgstream kdDebug	(	bool	cond,
		int	area = 0
	)

Definition at line 372 of file kdebug.cpp.

kdDebug() [2/2]

kdbgstream kdDebug ( int  area = 0 )

related

Returns a debug stream.

You can use it to print debug information.

Parameters

area	an id to identify the output, 0 for default

See also

kndDebug()

Definition at line 371 of file kdebug.cpp.

kdError() [1/2]

kdbgstream kdError	(	bool	cond,
		int	area = 0
	)

Definition at line 375 of file kdebug.cpp.

kdError() [2/2]

kdbgstream kdError ( int  area = 0 )

related

Returns an error stream.

You can use it to print error information.

Parameters

area	an id to identify the output, 0 for default

Definition at line 374 of file kdebug.cpp.

kdFatal() [1/2]

kdbgstream kdFatal	(	bool	cond,
		int	area = 0
	)

Definition at line 379 of file kdebug.cpp.

kdFatal() [2/2]

kdbgstream kdFatal ( int  area = 0 )

related

Returns a fatal error stream.

You can use it to print fatal error information.

Parameters

area	an id to identify the output, 0 for default

Definition at line 378 of file kdebug.cpp.

kdWarning() [1/2]

kdbgstream kdWarning	(	bool	cond,
		int	area = 0
	)

Definition at line 377 of file kdebug.cpp.

kdWarning() [2/2]

kdbgstream kdWarning ( int  area = 0 )

related

Returns a warning stream.

You can use it to print warning information.

Parameters

area	an id to identify the output, 0 for default

Definition at line 376 of file kdebug.cpp.

kndDebug() [1/2]

kndbgstream kndDebug ( bool  , int  = 0  )

inline

Definition at line 625 of file kdebug.h.

kndDebug() [2/2]

kndbgstream kndDebug ( int  area = 0 )

inline

Returns a dummy debug stream.

The stream does not print anything.

Parameters

area	an id to identify the output, 0 for default

See also

kdDebug()

Definition at line 624 of file kdebug.h.

operator<<()

template<class T >

kdbgstream & kdbgstream::operator<<

(

const TQValueList< T > &

list

)

Prints the given value.

Parameters

list	the list to print

Returns

this stream

Since

3.3

Definition at line 410 of file kdebug.h.

perror() [1/2]

kdbgstream & perror

(

kdbgstream &

s

)

Definition at line 370 of file kdebug.cpp.

perror() [2/2]

kndbgstream & perror ( kndbgstream &  s )

inline

Definition at line 590 of file kdebug.h.