BloombergLP::ball::Log::logMessage

Log a message with the specified category, severity, and location.

Synopsis

Declared in <ball_log.h>

static
void
logMessage(
    Category const* category,
    int severity,
    std::string_view const& fileName,
    int lineNumber,
    std::string_view const& message);

Description

Log a record containing the specified message text, fileName, lineNumber, severity, and the name of the specified category. (See the component-level documentation of ball_record for more information on the additional fields that are logged.) Store the record in the buffer held by the logger if severity is at least as severe as the current "Record" threshold level of category. Pass the record directly to the registered observer if severity is at least as severe as the current "Pass" threshold level of category. Publish the entire contents of the buffer of the logger if severity is at least as severe as the current "Trigger" threshold level of category. Publish the entire contents of all buffers of all loggers if severity is at least as severe as the current "Trigger-All" threshold level of category (i.e., via the callback supplied at construction of the logger manager singleton). This method has no effect if category is 0 or severity is less severe than each of the threshold levels of category. The behavior is undefined unless severity is in the range [1 .. 255] and the logger manager singleton is initialized when category is non-null.

Parameters

NameDescription
categorycategory under which the message is logged
severityseverity level of the log record
fileNamesource file name attribute for the record
lineNumbersource line number attribute for the record
messagetext of the log message