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

Name

Description

category

category under which the message is logged

severity

severity level of the log record

fileName

source file name attribute for the record

lineNumber

source line number attribute for the record

message

text of the log message

Created with MrDocs