drake::logging Namespace Reference

Classes
struct	Warn
	When constructed, logs a message (at "warn" severity); the destructor is guaranteed to be trivial. More...

Typedefs
using	logger = spdlog::logger
	The drake::logging::logger class provides text logging methods.

Functions
std::string	set_log_level (const std::string &level)
	Sets the log threshold used by Drake's C++ code.
void	set_log_pattern (const std::string &pattern)
	Invokes drake::log()->set_pattern(pattern).
spdlog::sinks::dist_sink_mt *	get_dist_sink ()
	(Advanced) Retrieves the default sink for all Drake logs.

Variables
constexpr bool	kHaveSpdlog = true
	True only if spdlog is enabled in this build.
const char *const	kSetLogLevelUnchanged
	The "unchanged" string to pass to set_log_level() so as to achieve a no-op.
const char *const	kSetLogLevelHelpMessage
	An end-user help string suitable to describe the effects of set_log_level().
const char *const	kSetLogPatternHelpMessage
	An end-user help string suitable to describe the effects of set_log_pattern().

Typedef Documentation

logger

using logger = spdlog::logger

The drake::logging::logger class provides text logging methods.

See the text_logging.h documentation for a short tutorial.

Function Documentation

get_dist_sink()

spdlog::sinks::dist_sink_mt * get_dist_sink

(

)

(Advanced) Retrieves the default sink for all Drake logs.

This allows consumers of Drake to redirect Drake's text logs to locations other than the default of stderr.

set_log_level()

std::string set_log_level

(

const std::string &

level

)

Sets the log threshold used by Drake's C++ code.

Parameters

level

Must be a string from spdlog enumerations: trace, debug, info, warn, err, critical, off, or unchanged (not an enum, but useful for command-line).

Returns

The string value of the previous log level. If SPDLOG is disabled, then this returns an empty string.

set_log_pattern()

void set_log_pattern

(

const std::string &

pattern

)

Invokes drake::log()->set_pattern(pattern).

Parameters

pattern

Formatting for message. For more information, see: https://github.com/gabime/spdlog/wiki/3.-Custom-formatting

Variable Documentation

kHaveSpdlog

bool kHaveSpdlog = true

constexpr

True only if spdlog is enabled in this build.

kSetLogLevelHelpMessage

const char* const kSetLogLevelHelpMessage

extern

An end-user help string suitable to describe the effects of set_log_level().

kSetLogLevelUnchanged

const char* const kSetLogLevelUnchanged

extern

The "unchanged" string to pass to set_log_level() so as to achieve a no-op.

kSetLogPatternHelpMessage

const char* const kSetLogPatternHelpMessage

extern

An end-user help string suitable to describe the effects of set_log_pattern().