BloombergLP::balst::StackTracePrintUtil::logExceptionStackTrace

Log an exception name, message, and stack trace via BSLS_LOG.

Synopsis

Declared in <balst_stacktraceprintutil.h>

static
void
logExceptionStackTrace(
    char const* exceptionName,
    char const* message);

Description

Log a message using BSLS_LOG consisting of "About to throw <exceptionName>. <message>" followed by a stack trace. This function is to be set as an exception "pre throw hook" for the component bslstl_stdexceptutil. If this function is set as the pre throw hook, it will be called prior to exceptions being thrown. Note that this function requires considerable disk access and is therefore slow, so it should not be used for frequently-occurring exceptions that are expected to be caught and recovered from.

Parameters

NameDescription
exceptionNamename of the exception about to be thrown
messageexplanatory message associated with the exception