Poco

class Debugger

Library: Foundation
Package: Core
Header: Poco/Debugger.h

Description

The Debugger class provides an interface to the debugger. The presence of a debugger can be checked for, messages can be written to the debugger's log window and a break into the debugger can be enforced. The methods only work if the program is compiled in debug mode (the macro _DEBUG is defined).

Member Summary

Member Functions: enter, isAvailable, message

Member Functions

enter static

static void enter();

Breaks into the debugger, if it is available. On Windows, this is done using the DebugBreak() function. On Unix, the SIGINT signal is raised.

enter static

static void enter(
    const std::string & msg
);

Writes a debug message to the debugger log and breaks into it.

enter static

static void enter(
    const std::string & msg,
    const char * file,
    int line
);

Writes a debug message to the debugger log and breaks into it.

enter static

static void enter(
    const char * file,
    int line
);

Writes a debug message to the debugger log and breaks into it.

isAvailable static

static bool isAvailable();

Returns true if a debugger is available, false otherwise. On Windows, this function uses the IsDebuggerPresent() function. On Unix, this function returns true if the environment variable POCO_ENABLE_DEBUGGER is set.

message static

static void message(
    const std::string & msg
);

Writes a message to the debugger log, if available, otherwise to standard error output.

message static

static void message(
    const std::string & msg,
    const char * file,
    int line
);

Writes a message to the debugger log, if available, otherwise to standard error output.