dist/common/Logging.h

18  * there is the filter level. Any log message that is assigned a level
19  * higher than the current filter level is discarded. Secondly there is the
20  * current output level. Log messages that do not have their own level
21  * use the current output level to determine if they should be shown or
33  * output logging level.
50 		URGENT = 0,	//!< The lowest level, for messages that must always be logged.
53 		INFO,		//!< The normal log level, for status messages.
56 		DEBUG2		//!< Highest log level; verbose debug logging.
68 	//! \brief Changes the logging level to \a level.
69 	inline void setFilterLevel(log_level_t level) { m_filter = level; }
71 	//! \brief Returns the current logging filter level.
74 	//! \brief Changes the logging output level to \a level.
75 	inline void setOutputLevel(log_level_t level) { m_level = level; }
77 	//! \brief Returns the current logging output level.
89 	//! \brief Log with format at a specific output level.
90 	virtual void log(log_level_t level, const char * fmt, ...);
92 	//! \brief Log a string output at a specific output level.
93 	virtual void log(log_level_t level, const std::string & msg) { log(level, msg.c_str()); }
98 	//! \brief Log with format using an argument with a specific output level.
99 	virtual void log(log_level_t level, const char * fmt, va_list args);
103 	log_level_t m_filter;	//!< The current logging filter level.
104 	log_level_t m_level;	//!< The current log output level.
120  * C++ scoping rules to temporarily change the output logging level. When the
121  * SetOutputLevel instance falls out of scope the output level is restored
144 	//! \brief Log with format at a specific output level.
145 	static void log(Logger::log_level_t level, const char * fmt, ...);
147 	//! \brief Log a string output at a specific output level.
148 	static void log(Logger::log_level_t level, const std::string & msg);
156 	 * \brief Utility class to temporarily change the logging output level.
158 	 * This class will change the current logging output level of a given
160 	 * level back to what it was originally.
164 	 *		// output level is some value here
167 	 *			// now output level is DEBUG
171 	 *		// output level is restored to previous value
179 		//! Saves the current logging output level of the global logger,
180 		//! as managed by the Log class, and sets the new level to \a level.
181 		SetOutputLevel(Logger::log_level_t level)
186 			m_logger->setOutputLevel(level);
191 		//! Saves the current logging output level of \a logger and sets
192 		//! the new level to \a level.
193 		SetOutputLevel(Logger * logger, Logger::log_level_t level)
197 			m_logger->setOutputLevel(level);
202 		//! Restores the saved logging output level.
210 		Logger::log_level_t m_saved;	//!< Original logging output level.