Debug message generators

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

Classes
class	KDebug
struct	KDebugTag
class	kndbgstream
Defines
#define	k_funcinfo   ""
#define	k_lineinfo   "[" << __FILE__ << ":" << __LINE__ << "] "
#define	KDE_DEBUG_ENABLED_BY_DEFAULT   true
#define	KDE_DEFAULT_DEBUG_AREA   0
#define	kDebug   KDebug(QtDebugMsg, __FILE__, __LINE__, Q_FUNC_INFO)
#define	kWarning   KDebug(QtWarningMsg, __FILE__, __LINE__, Q_FUNC_INFO)
Typedefs
typedef QDebug	kdbgstream
typedef QDebug(*	KDebugStreamFunction )(QDebug, KDebugTag)
Functions
KDE_DEPRECATED QString	kdBacktrace (int levels=-1)
static KDE_DEPRECATED QDebug	kdDebug (int area=KDE_DEFAULT_DEBUG_AREA)
static QDebug	kDebug (bool cond, int area=KDE_DEFAULT_DEBUG_AREA)
QDebug	kDebugDevNull ()
QDebug	kDebugStream (QtMsgType level, int area, const char *file=0, int line=-1, const char *funcinfo=0)
static KDE_DEPRECATED QDebug	kdError (int area=KDE_DEFAULT_DEBUG_AREA)
static KDE_DEPRECATED QDebug	kdFatal (int area=KDE_DEFAULT_DEBUG_AREA)
static KDE_DEPRECATED QDebug	kdWarning (int area=KDE_DEFAULT_DEBUG_AREA)
static QDebug	kError (bool cond, int area=KDE_DEFAULT_DEBUG_AREA)
static QDebug	kFatal (bool cond, int area=KDE_DEFAULT_DEBUG_AREA)
static KDE_DEPRECATED QDebug	kndDebug ()
QString	kRealBacktrace (int)
static QDebug	kWarning (bool cond, int area=KDE_DEFAULT_DEBUG_AREA)
QDebug	operator<< (QDebug s, const KDateTime &time)
QDebug	operator<< (QDebug s, const KUrl &url)
QDebug	operator<< (QDebug s, KDebugStreamFunction f)

---

Detailed Description

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

Debug message printing is controlled by (un)defining QT_NO_DEBUG when compiling your source. If QT_NO_DEBUG is defined then debug messages are not printed by default but can still be enabled by runtime configuration, e.g. via kdebugdialog or by editing kdebugrc.

---

Define Documentation

#define k_funcinfo   ""

An indicator of where you are in a source file, to be used in warnings (perhaps debug messages too).

Deprecated:

kDebug takes care of printing the method name automatically now

Definition at line 62 of file kdebug.h.

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

An indicator of where you are in a source file, to be used in warnings (perhaps debug messages too).

Gives an accurate idea of where the message comes from. Not suitable for user-visible messages.

Deprecated:

kDebug takes care of printing the method name automatically now

Definition at line 71 of file kdebug.h.

#define KDE_DEBUG_ENABLED_BY_DEFAULT   true

Definition at line 54 of file kdebug.h.

#define KDE_DEFAULT_DEBUG_AREA   0

Definition at line 116 of file kdebug.h.

#define kDebug   KDebug(QtDebugMsg, __FILE__, __LINE__, Q_FUNC_INFO)

Definition at line 305 of file kdebug.h.

#define kWarning   KDebug(QtWarningMsg, __FILE__, __LINE__, Q_FUNC_INFO)

Definition at line 311 of file kdebug.h.

---

Typedef Documentation

typedef QDebug kdbgstream

Definition at line 219 of file kdebug.h.

typedef QDebug(* KDebugStreamFunction)(QDebug, KDebugTag)

!

For internal use only.

just a tag class

Definition at line 197 of file kdebug.h.

---

Function Documentation

KDE_DEPRECATED QString kdBacktrace

(

int

levels = -1

)

[inline]

Definition at line 225 of file kdebug.h.

static KDE_DEPRECATED QDebug kdDebug

(

int

area = KDE_DEFAULT_DEBUG_AREA

)

[inline, static]

Definition at line 221 of file kdebug.h.

static QDebug kDebug	(	bool	cond,
		int	area = KDE_DEFAULT_DEBUG_AREA
	)			[inline, static]

Definition at line 149 of file kdebug.h.

QDebug kDebugDevNull

(

)

For internal use only.

Returns a debug stream that goes the way of the blackhole.

Definition at line 680 of file kdebug.cpp.

QDebug kDebugStream	(	QtMsgType	level,
		int	area,
		const char *	file = 0,
		int	line = -1,
		const char *	funcinfo = 0
	)

For internal use only.

Returns a debug stream that may or may not output anything.

Definition at line 685 of file kdebug.cpp.

static KDE_DEPRECATED QDebug kdError

(

int

area = KDE_DEFAULT_DEBUG_AREA

)

[inline, static]

Definition at line 223 of file kdebug.h.

static KDE_DEPRECATED QDebug kdFatal

(

int

area = KDE_DEFAULT_DEBUG_AREA

)

[inline, static]

Definition at line 224 of file kdebug.h.

static KDE_DEPRECATED QDebug kdWarning

(

int

area = KDE_DEFAULT_DEBUG_AREA

)

[inline, static]

Definition at line 222 of file kdebug.h.

static QDebug kError	(	bool	cond,
		int	area = KDE_DEFAULT_DEBUG_AREA
	)			[inline, static]

Definition at line 182 of file kdebug.h.

static QDebug kFatal	(	bool	cond,
		int	area = KDE_DEFAULT_DEBUG_AREA
	)			[inline, static]

Definition at line 193 of file kdebug.h.

static KDE_DEPRECATED QDebug kndDebug

(

)

[inline, static]

Definition at line 227 of file kdebug.h.

QString kRealBacktrace

(

int

)

For internal use only.

The actual backtrace.

Definition at line 655 of file kdebug.cpp.

static QDebug kWarning	(	bool	cond,
		int	area = KDE_DEFAULT_DEBUG_AREA
	)			[inline, static]

Definition at line 166 of file kdebug.h.

QDebug operator<<	(	QDebug	s,
		const KDateTime &	time
	)

Definition at line 706 of file kdebug.cpp.

QDebug operator<<	(	QDebug	s,
		const KUrl &	url
	)

Definition at line 715 of file kdebug.cpp.

QDebug operator<<	(	QDebug	s,
		KDebugStreamFunction	f
	)			[inline]

Definition at line 198 of file kdebug.h.