BloombergLP::ball::LoggerManager::initSingleton

Synopses

Declared in <ball_loggermanager.h>

Initialize the logger manager singleton. Optionally specify a configuration describing how the singleton should be configured. If configuration is not specified, a default constructed LoggerManagerConfiguration object is used. Optionally specify a globalAllocator used to supply memory. If globalAllocator is 0, the currently installed global allocator is used. Return a non-const reference to the logger manager singleton. This method has no effect (aside from logging a warning) if the logger manager singleton already exists.

static
LoggerManager&
initSingleton(bslma::Allocator* globalAllocator = 0);

» more...

Same as the preceding overload, using the specified configuration.

static
LoggerManager&
initSingleton(
    LoggerManagerConfiguration const& configuration,
    bslma::Allocator* globalAllocator = 0);

» more...

Initialize the logger manager singleton with the specified singleton. Optionally specify an adoptSingleton flag indicating whether this method takes ownership of singleton, in which case shutDownSingleton will destroy singleton. If adoptSingleton is not specified, this method does not take ownership of singleton (and shutDownSingleton will not destroy it). Return 0 if the logger manager singleton was successfully initialized, and a non-zero value otherwise. This method has no effect (aside from logging a warning) if the logger manager singleton already exists, in which case this method does not take ownership of singleton regardless of the value of adoptSingleton. Note that this version of initSingleton is meant for use only on Windows to initialize another dynamically loaded copy of the LoggerManager system. Also note that a suitable singleton may be obtained by calling createLoggerManager, or from the singleton class method of an already-initialized LoggerManager system.

static
int
initSingleton(
    LoggerManager* singleton,
    bool adoptSingleton = false);

» more...

Initialize the logger manager singleton having the specified observer that receives published log records. Optionally specify a configuration describing how the singleton should be configured. If configuration is not specified, a default constructed LoggerManagerConfiguration object is used. Optionally specify a globalAllocator used to supply memory. If globalAllocator is 0, the currently installed global allocator is used. Return a non-const reference to the logger manager singleton. This method has no effect (aside from logging a warning) if the logger manager singleton already exists. The behavior is undefined if observer is 0, goes out of scope, or is otherwise destroyed.

static
LoggerManager&
initSingleton(
    Observer* observer,
    bslma::Allocator* globalAllocator = 0);

» more...

Same as the preceding overload, using the specified configuration.

static
LoggerManager&
initSingleton(
    Observer* observer,
    LoggerManagerConfiguration const& configuration,
    bslma::Allocator* globalAllocator = 0);

» more...