Namespaces
	backend

	impl

	levels

Classes
struct	FileToken

class	FilterBase
	Base-class for filters. Filters allow full user-defined control over whether or not a message should print. The ROS_X_FILTER... macros provide the filtering functionality. More...

struct	FilterParams
	Parameter structure passed to FilterBase::isEnabled(...);. Includes both input and output parameters. More...

struct	FixedMapToken

struct	FixedToken

struct	Formatter

struct	FunctionToken

struct	LineToken

class	LogAppender

struct	LoggerToken

struct	LogLocation
	Internal. More...

struct	MessageToken

struct	PlaceHolderToken

struct	SeverityToken

class	StaticInit

struct	ThreadToken

struct	TimeToken

struct	Token

struct	WallTimeToken

Typedefs
typedef levels::Level	Level

typedef std::map< std::string, std::string >	M_string

typedef boost::shared_ptr< Token >	TokenPtr

typedef std::vector< LogLocation * >	V_LogLocation

typedef std::vector< TokenPtr >	V_Token

Functions
void	_print (void logger_handle, ::ros::console::Level level, const char str, const char file, const char function, int line)

ROSCONSOLE_DECL void	checkLogLocationEnabled (LogLocation *loc)
	Internal. More...

void	checkLogLocationEnabledNoLock (LogLocation *loc)

TokenPtr	createTokenFromType (const std::string &type)

ROSCONSOLE_DECL void	deregister_appender (LogAppender *appender)

ROSCONSOLE_DECL void	formatToBuffer (boost::shared_array< char > &buffer, size_t &buffer_size, const char *fmt,...)

ROSCONSOLE_DECL std::string	formatToString (const char *fmt,...)

static boost::shared_array< char >	g_print_buffer (new char[INITIAL_BUFFER_SIZE])

ROSCONSOLE_DECL bool	get_loggers (std::map< std::string, levels::Level > &loggers)

ROSCONSOLE_DECL void	initialize ()
	Don't call this directly. Performs any required initialization/configuration. Happens automatically when using the macro API. More...

ROSCONSOLE_DECL void	initializeLogLocation (LogLocation *loc, const std::string &name, Level level)
	Internal. More...

ROSCONSOLE_DECL void	notifyLoggerLevelsChanged ()
	Tells the system that a logger's level has changed. More...

ROSCONSOLE_DECL void	print (FilterBase filter, void logger, Level level, const char file, int line, const char function, const char *fmt,...) ROSCONSOLE_PRINTF_ATTRIBUTE(7
	Don't call this directly. Use the ROS_LOG() macro instead. More...

ROSCONSOLE_DECL void ROSCONSOLE_DECL void	print (FilterBase filter, void logger, Level level, const std::stringstream &str, const char file, int line, const char function)

ROSCONSOLE_DECL void	register_appender (LogAppender *appender)

ROSCONSOLE_DECL void	registerLogLocation (LogLocation *loc)
	Registers a logging location with the system. More...

ROSCONSOLE_DECL bool	set_logger_level (const std::string &name, levels::Level level)

ROSCONSOLE_DECL void	setFixedFilterToken (const std::string &key, const std::string &val)

ROSCONSOLE_DECL void	setLogLocationLevel (LogLocation *loc, Level level)
	Internal. More...

ROSCONSOLE_DECL void	shutdown ()

ROSCONSOLE_DECL void	vformatToBuffer (boost::shared_array< char > &buffer, size_t &buffer_size, const char *fmt, va_list args)

Variables
bool	g_color = true

M_string	g_extra_fixed_tokens

bool	g_force_stdout_line_buffered = false

const char *	g_format_string = "[${severity}] [${time}]: ${message}"

ROSCONSOLE_DECL Formatter	g_formatter
	Only exported because the implementation need it. Do not use directly. More...

boost::mutex	g_init_mutex

ROSCONSOLE_DECL bool	g_initialized = false
	Only exported because the macros need it. Do not use directly. More...

ROSCONSOLE_DECL std::string	g_last_error_message = "Unknown Error"
	Only exported because the TopicManager need it. Do not use directly. More...

boost::mutex	g_locations_mutex

V_LogLocation	g_log_locations

static size_t	g_print_buffer_size = INITIAL_BUFFER_SIZE

static boost::mutex	g_print_mutex

static boost::thread::id	g_printing_thread_id

bool	g_shutting_down = false

StaticInit	g_static_init

bool	g_stdout_flush_failure_reported = false

struct ROSCONSOLE_DECL	LogLocation

Typedef Documentation

◆ Level

typedef levels::Level ros::console::Level

Definition at line 64 of file console_backend.h.

◆ M_string

typedef std::map<std::string, std::string> ros::console::M_string

Definition at line 92 of file rosconsole.cpp.

◆ TokenPtr

typedef boost::shared_ptr<Token> ros::console::TokenPtr

Definition at line 126 of file console.h.

◆ V_LogLocation

typedef std::vector<LogLocation*> ros::console::V_LogLocation

Definition at line 619 of file rosconsole.cpp.

◆ V_Token

typedef std::vector<TokenPtr> ros::console::V_Token

Definition at line 127 of file console.h.

Function Documentation

◆ _print()

void ros::console::_print	(	void *	logger_handle,
		::ros::console::Level	level,
		const char *	str,
		const char *	file,
		const char *	function,
		int	line
	)

Definition at line 398 of file rosconsole.cpp.

◆ checkLogLocationEnabled()

void ros::console::checkLogLocationEnabled ( LogLocation * loc )

Internal.

Definition at line 659 of file rosconsole.cpp.

◆ checkLogLocationEnabledNoLock()

void ros::console::checkLogLocationEnabledNoLock ( LogLocation * loc )

Definition at line 629 of file rosconsole.cpp.

◆ createTokenFromType()

TokenPtr ros::console::createTokenFromType ( const std::string & type )

Definition at line 256 of file rosconsole.cpp.

◆ deregister_appender()

void ros::console::deregister_appender ( LogAppender * appender )

Definition at line 694 of file rosconsole.cpp.

◆ formatToBuffer()

void ros::console::formatToBuffer	(	boost::shared_array< char > &	buffer,
		size_t &	buffer_size,
		const char *	fmt,
			...
	)

Definition at line 464 of file rosconsole.cpp.

◆ formatToString()

std::string ros::console::formatToString	(	const char *	fmt,
			...
	)

Definition at line 474 of file rosconsole.cpp.

◆ g_print_buffer()

static boost::shared_array<char> ros::console::g_print_buffer ( new char[INITIAL_BUFFER_SIZE] )

static

◆ get_loggers()

bool ros::console::get_loggers ( std::map< std::string, levels::Level > & loggers )

Definition at line 705 of file rosconsole.cpp.

◆ initialize()

void ros::console::initialize ( )

Don't call this directly. Performs any required initialization/configuration. Happens automatically when using the macro API.

If you're going to be using log4cxx or any of the ros::console functions, and need the system to be initialized, use the ROSCONSOLE_AUTOINIT macro.

Definition at line 403 of file rosconsole.cpp.

◆ initializeLogLocation()

void ros::console::initializeLogLocation	(	LogLocation *	loc,
		const std::string &	name,
		Level	level
	)

Internal.

Definition at line 634 of file rosconsole.cpp.

◆ notifyLoggerLevelsChanged()

void ros::console::notifyLoggerLevelsChanged ( )

Tells the system that a logger's level has changed.

This must be called if a log4cxx::Logger's level has been changed in the middle of an application run. Because of the way the static guard for enablement works, if a logger's level is changed and this function is not called, only logging statements which are first hit after the change will be correct wrt that logger.

Definition at line 665 of file rosconsole.cpp.

◆ print() [1/2]

void ros::console::print	(	FilterBase *	filter,
		void *	logger,
		Level	level,
		const char *	file,
		int	line,
		const char *	function,
		const char *	fmt,
			...
	)

Don't call this directly. Use the ROS_LOG() macro instead.

Parameters

level	Logging level
file	File this logging statement is from (usually generated with FILE)
line	Line of code this logging statement is from (usually generated with LINE)
fmt	Format string

Definition at line 494 of file rosconsole.cpp.

◆ print() [2/2]

void ros::console::print	(	FilterBase *	filter,
		void *	logger,
		Level	level,
		const std::stringstream &	str,
		const char *	file,
		int	line,
		const char *	function
	)

Definition at line 563 of file rosconsole.cpp.

◆ register_appender()

void ros::console::register_appender ( LogAppender * appender )

Definition at line 689 of file rosconsole.cpp.

◆ registerLogLocation()

void ros::console::registerLogLocation ( LogLocation * loc )

Registers a logging location with the system.

This is used for the case where a logger's verbosity level changes, and we need to reset the enabled status of all the logging statements.

Parameters

loc	The location to add

Definition at line 622 of file rosconsole.cpp.

◆ set_logger_level()

bool ros::console::set_logger_level	(	const std::string &	name,
		levels::Level	level
	)

Definition at line 710 of file rosconsole.cpp.

◆ setFixedFilterToken()

void ros::console::setFixedFilterToken	(	const std::string &	key,
		const std::string &	val
	)

Definition at line 95 of file rosconsole.cpp.

◆ setLogLocationLevel()

void ros::console::setLogLocationLevel	(	LogLocation *	loc,
		Level	level
	)

Internal.

Definition at line 653 of file rosconsole.cpp.

◆ shutdown()

void ros::console::shutdown ( )

Definition at line 699 of file rosconsole.cpp.

◆ vformatToBuffer()

void ros::console::vformatToBuffer	(	boost::shared_array< char > &	buffer,
		size_t &	buffer_size,
		const char *	fmt,
		va_list	args
	)

Definition at line 450 of file rosconsole.cpp.

Variable Documentation

◆ g_color

bool ros::console::g_color = true

Definition at line 90 of file rosconsole.cpp.

◆ g_extra_fixed_tokens

M_string ros::console::g_extra_fixed_tokens

Definition at line 93 of file rosconsole.cpp.

◆ g_force_stdout_line_buffered

bool ros::console::g_force_stdout_line_buffered = false

Definition at line 88 of file rosconsole.cpp.

◆ g_format_string

const char* ros::console::g_format_string = "[${severity}] [${time}]: ${message}"

Definition at line 86 of file rosconsole.cpp.

◆ g_formatter

Formatter ros::console::g_formatter

Only exported because the implementation need it. Do not use directly.

Definition at line 395 of file rosconsole.cpp.

◆ g_init_mutex

boost::mutex ros::console::g_init_mutex

Definition at line 61 of file rosconsole.cpp.

◆ g_initialized

bool ros::console::g_initialized = false

Only exported because the macros need it. Do not use directly.

Definition at line 59 of file rosconsole.cpp.

◆ g_last_error_message

std::string ros::console::g_last_error_message = "Unknown Error"

Only exported because the TopicManager need it. Do not use directly.

Definition at line 73 of file rosconsole.cpp.

◆ g_locations_mutex

boost::mutex ros::console::g_locations_mutex

Definition at line 621 of file rosconsole.cpp.

◆ g_log_locations

V_LogLocation ros::console::g_log_locations

Definition at line 620 of file rosconsole.cpp.

◆ g_print_buffer_size

size_t ros::console::g_print_buffer_size = INITIAL_BUFFER_SIZE

static

Definition at line 492 of file rosconsole.cpp.

◆ g_print_mutex

boost::mutex ros::console::g_print_mutex

static

Definition at line 490 of file rosconsole.cpp.

◆ g_printing_thread_id

boost::thread::id ros::console::g_printing_thread_id

static

Definition at line 493 of file rosconsole.cpp.

◆ g_shutting_down

bool ros::console::g_shutting_down = false

Definition at line 60 of file rosconsole.cpp.

◆ g_static_init

StaticInit ros::console::g_static_init

Definition at line 686 of file rosconsole.cpp.

◆ g_stdout_flush_failure_reported

bool ros::console::g_stdout_flush_failure_reported = false

Definition at line 89 of file rosconsole.cpp.

◆ LogLocation

struct ROSCONSOLE_DECL ros::console::LogLocation

Definition at line 165 of file console.h.

Namespaces

Classes

Typedefs

Functions

Variables

Typedef Documentation

◆ Level

◆ M_string

◆ TokenPtr

◆ V_LogLocation

◆ V_Token

Function Documentation

◆ _print()

◆ checkLogLocationEnabled()

◆ checkLogLocationEnabledNoLock()

◆ createTokenFromType()

◆ deregister_appender()

◆ formatToBuffer()

◆ formatToString()

◆ g_print_buffer()

◆ get_loggers()

◆ initialize()

◆ initializeLogLocation()

◆ notifyLoggerLevelsChanged()

◆ print() [1/2]

◆ print() [2/2]

◆ register_appender()

◆ registerLogLocation()

◆ set_logger_level()

◆ setFixedFilterToken()

◆ setLogLocationLevel()

◆ shutdown()

◆ vformatToBuffer()

Variable Documentation

◆ g_color

◆ g_extra_fixed_tokens

◆ g_force_stdout_line_buffered

◆ g_format_string

◆ g_formatter

◆ g_init_mutex

◆ g_initialized

◆ g_last_error_message

◆ g_locations_mutex

◆ g_log_locations

◆ g_print_buffer_size

◆ g_print_mutex

◆ g_printing_thread_id

◆ g_shutting_down

◆ g_static_init

◆ g_stdout_flush_failure_reported

◆ LogLocation