BloombergLP::ball::Logger::obtainMessageBuffer

Return exclusive access to this logger's message formatting buffer.

Synopsis

Declared in <ball_loggermanager.h>

char*
obtainMessageBuffer(
    bslmt::Mutex** mutex,
    int* bufferSize);

Description

Block until access to the buffer of this logger used for formatting messages is available. Return the address of the modifiable buffer to which this thread of execution has exclusive access, load the address of the mutex that protects the buffer into the specified *mutex address, and load the size (in bytes) of the buffer into the specified bufferSize address. The address remains valid, and the buffer remains locked by this thread of execution, until this thread calls mutex‐>unlock(). The behavior is undefined if this thread of execution currently holds a lock on the buffer. Note that the buffer is intended to be used only for formatting log messages immediately before calling logMessage; other use may adversely affect performance for the entire program.

Return Value

address of the modifiable buffer to which this thread has exclusive access

Parameters

Name

Description

mutex

address at which to store the buffer‐protecting mutex

bufferSize

address at which to store the buffer size in bytes

Created with MrDocs