el Namespace Reference

Easylogging++ entry namespace. More...

Namespaces
	base
	Namespace containing base/internal functionality used by Easylogging++.

Classes
class	Callback
class	Configuration
	Represents single configuration that has representing level, configuration type and a string based value. More...
class	Configurations
	Thread-safe Configuration repository. More...
struct	ConfigurationStringToTypeItem
class	ConfigurationTypeHelper
	Static class that contains helper functions for el::ConfigurationType. More...
class	CustomFormatSpecifier
	User-provided custom format specifier. More...
class	Helpers
	Static helpers for developers. More...
class	LevelHelper
	Static class that contains helper functions for el::Level. More...
class	LogBuilder
class	LogDispatchCallback
class	LogDispatchData
class	Loggable
	Base of Easylogging++ friendly class. More...
class	Logger
	Represents a logger holding ID and configurations we need to write logs. More...
class	LoggerRegistrationCallback
class	Loggers
	Static helpers to deal with loggers and their configurations. More...
class	LogMessage
class	PerformanceTrackingCallback
struct	StringToLevelItem
class	SysLogInitializer
	Initializes syslog with process ID, options and facility. calls closelog() on d'tor. More...
class	VersionInfo

Typedefs
typedef std::function< std::string(const LogMessage *)>	FormatSpecifierValueResolver
	Resolving function for format specifier. More...
typedef std::shared_ptr< LogBuilder >	LogBuilderPtr
typedef std::function< void(const char *, std::size_t)>	PreRollOutCallback

Enumerations
enum	ConfigurationType : base::type::EnumType {   ConfigurationType::Enabled = 1, ConfigurationType::ToFile = 2, ConfigurationType::ToStandardOutput = 4, ConfigurationType::Format = 8,   ConfigurationType::Filename = 16, ConfigurationType::SubsecondPrecision = 32, ConfigurationType::MillisecondsWidth = SubsecondPrecision, ConfigurationType::PerformanceTracking = 64,   ConfigurationType::MaxLogFileSize = 128, ConfigurationType::LogFlushThreshold = 256, ConfigurationType::Unknown = 1010 }
	Represents enumeration of ConfigurationType used to configure or access certain aspect of logging. More...
enum	Level : base::type::EnumType {   Level::Global = 1, Level::Trace = 2, Level::Debug = 4, Level::Fatal = 8,   Level::Error = 16, Level::Warning = 32, Level::Verbose = 64, Level::Info = 128,   Level::Unknown = 1010 }
	Represents enumeration for severity level used to determine level of logging. More...
enum	LoggingFlag : base::type::EnumType {   LoggingFlag::NewLineForContainer = 1, LoggingFlag::AllowVerboseIfModuleNotSpecified = 2, LoggingFlag::LogDetailedCrashReason = 4, LoggingFlag::DisableApplicationAbortOnFatalLog = 8,   LoggingFlag::ImmediateFlush = 16, LoggingFlag::StrictLogFileSizeCheck = 32, LoggingFlag::ColoredTerminalOutput = 64, LoggingFlag::MultiLoggerSupport = 128,   LoggingFlag::DisablePerformanceTrackingCheckpointComparison = 256, LoggingFlag::DisableVModules = 512, LoggingFlag::DisableVModulesExtensions = 1024, LoggingFlag::HierarchicalLogging = 2048,   LoggingFlag::CreateLoggerAutomatically = 4096, LoggingFlag::AutoSpacing = 8192, LoggingFlag::FixedTimeFormat = 16384, LoggingFlag::IgnoreSigInt = 32768 }
	Flags used while writing logs. This flags are set by user. More...

Variables
static struct ConfigurationStringToTypeItem	configStringToTypeMap []
base::debug::CrashHandler	elCrashHandler
static struct StringToLevelItem	stringToLevelMap []

Detailed Description

Easylogging++ entry namespace.

Typedef Documentation

typedef std::function<std::string(const LogMessage*)> el::FormatSpecifierValueResolver

Resolving function for format specifier.

Definition at line 1635 of file easylogging++.h.

typedef std::shared_ptr<LogBuilder> el::LogBuilderPtr

Definition at line 2201 of file easylogging++.h.

typedef std::function<void(const char*, std::size_t)> el::PreRollOutCallback

Definition at line 801 of file easylogging++.h.

Enumeration Type Documentation

enum el::ConfigurationType : base::type::EnumType

strong

Represents enumeration of ConfigurationType used to configure or access certain aspect of logging.

Enumerator
Enabled	Determines whether or not corresponding level and logger of logging is enabled You may disable all logs by using el::Level::Global.
ToFile	Whether or not to write corresponding log to log file.
ToStandardOutput	Whether or not to write corresponding level and logger log to standard output. By standard output meaning termnal, command prompt etc.
Format	Determines format of logging corresponding level and logger.
Filename	Determines log file (full path) to write logs to for correponding level and logger.
SubsecondPrecision	Specifies precision of the subsecond part. It should be within range (1-6).
MillisecondsWidth	Alias of SubsecondPrecision (for backward compatibility)
PerformanceTracking	Determines whether or not performance tracking is enabled. This does not depend on logger or level. Performance tracking always uses 'performance' logger
MaxLogFileSize	Specifies log file max size. If file size of corresponding log file (for corresponding level) is >= specified size, log file will be truncated and re-initiated.
LogFlushThreshold	Specifies number of log entries to hold until we flush pending log data.
Unknown	Represents unknown configuration.

Definition at line 628 of file easylogging++.h.

enum el::Level : base::type::EnumType

strong

Represents enumeration for severity level used to determine level of logging.

With Easylogging++, developers may disable or enable any level regardless of what the severity is. Or they can choose to log using hierarchical logging flag

Enumerator
Global	Generic level that represents all the levels. Useful when setting global configuration for all levels.
Trace	Information that can be useful to back-trace certain events - mostly useful than debug logs.
Debug	Informational events most useful for developers to debug application.
Fatal	Severe error information that will presumably abort application.
Error	Information representing errors in application but application will keep running.
Warning	Useful when application has potentially harmful situtaions.
Verbose	Information that can be highly useful and vary with verbose logging level.
Info	Mainly useful to represent current progress of application.
Unknown	Represents unknown level.

Definition at line 568 of file easylogging++.h.

enum el::LoggingFlag : base::type::EnumType

strong

Flags used while writing logs. This flags are set by user.

Enumerator
NewLineForContainer	Makes sure we have new line for each container log entry.
AllowVerboseIfModuleNotSpecified	Makes sure if -vmodule is used and does not specifies a module, then verbose logging is allowed via that module.
LogDetailedCrashReason	When handling crashes by default, detailed crash reason will be logged as well.
DisableApplicationAbortOnFatalLog	Allows to disable application abortion when logged using FATAL level.
ImmediateFlush	Flushes log with every log-entry (performance sensative) - Disabled by default.
StrictLogFileSizeCheck	Enables strict file rolling.
ColoredTerminalOutput	Make terminal output colorful for supported terminals.
MultiLoggerSupport	Supports use of multiple logging in same macro, e.g, CLOG(INFO, "default", "network")
DisablePerformanceTrackingCheckpointComparison	Disables comparing performance tracker's checkpoints.
DisableVModules	Disable VModules.
DisableVModulesExtensions	Disable VModules extensions.
HierarchicalLogging	Enables hierarchical logging.
CreateLoggerAutomatically	Creates logger automatically when not available.
AutoSpacing	Adds spaces b/w logs that separated by left-shift operator.
FixedTimeFormat	Preserves time format and does not convert it to sec, hour etc (performance tracking only)
IgnoreSigInt

Definition at line 689 of file easylogging++.h.

Variable Documentation

struct ConfigurationStringToTypeItem el::configStringToTypeMap[]

static

Initial value:

= {
  { "enabled", ConfigurationType::Enabled },
  { "to_file", ConfigurationType::ToFile },
  { "to_standard_output", ConfigurationType::ToStandardOutput },
  { "format", ConfigurationType::Format },
  { "filename", ConfigurationType::Filename },
  { "subsecond_precision", ConfigurationType::SubsecondPrecision },
  { "milliseconds_width", ConfigurationType::MillisecondsWidth },
  { "performance_tracking", ConfigurationType::PerformanceTracking },
  { "max_log_file_size", ConfigurationType::MaxLogFileSize },
  { "log_flush_threshold", ConfigurationType::LogFlushThreshold },
}

Definition at line 209 of file easylogging++.cc.

base::debug::CrashHandler el::elCrashHandler

struct StringToLevelItem el::stringToLevelMap[]

static

Initial value:

= {
  { "global", Level::Global },
  { "debug", Level::Debug },
  { "info", Level::Info },
  { "warning", Level::Warning },
  { "error", Level::Error },
  { "fatal", Level::Fatal },
  { "verbose", Level::Verbose },
  { "trace", Level::Trace }
}

Definition at line 158 of file easylogging++.cc.