diff --git a/build_all.sh b/build_all.sh index 12aa9f1..b8448e9 100755 --- a/build_all.sh +++ b/build_all.sh @@ -20,6 +20,9 @@ rm -f build_all.log for t in "Debug" "Release" "RelWithDebInfo"; do for w in "ON" "OFF"; do build $t $w + cd ${t}_${w} + ctest + cd .. done done diff --git a/clutchlog/clutchlog.h b/clutchlog/clutchlog.h index 28b42c8..ace3d71 100644 --- a/clutchlog/clutchlog.h +++ b/clutchlog/clutchlog.h @@ -4,12 +4,12 @@ /** @file */ #include -#ifdef FSEXPERIMENTAL -#include -namespace fs = std::experimental::filesystem; + #ifdef FSEXPERIMENTAL + #include + namespace fs = std::experimental::filesystem; #else -#include -namespace fs = std::filesystem; + #include + namespace fs = std::filesystem; #endif #include @@ -23,23 +23,23 @@ namespace fs = std::filesystem; #include #if __has_include() && __has_include() && __has_include() -#include // execinfo -#include // getenv -#include // basename -//! POSIX headers necessary for stack depth management are available. -#define CLUTCHLOG_HAVE_UNIX_SYSINFO 1 + #include // execinfo + #include // getenv + #include // basename + //! POSIX headers necessary for stack depth management are available. + #define CLUTCHLOG_HAVE_UNIX_SYSINFO 1 #else -#define CLUTCHLOG_HAVE_UNIX_SYSINFO 0 + #define CLUTCHLOG_HAVE_UNIX_SYSINFO 0 #endif /********************************************************************** * Enable by default in Debug builds. **********************************************************************/ #ifndef WITH_CLUTCHLOG -#ifndef NDEBUG -//! Actually enable clutchlog features. -#define WITH_CLUTCHLOG -#endif + #ifndef NDEBUG + //! Actually enable clutchlog features. + #define WITH_CLUTCHLOG + #endif #endif /********************************************************************** @@ -50,45 +50,14 @@ namespace fs = std::filesystem; /** @addtogroup DefaultConfigMacros Default configuration macros * @{ **/ -#ifndef CLUTCHLOG_DEFAULT_FORMAT -//! Default format of the messages. -#if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 -#define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" -#else -#define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" -#endif -#endif // CLUTCHLOG_DEFAULT_FORMAT - -#ifndef CLUTCHDUMP_DEFAULT_FORMAT -//! Default format of the comment line in file dump. -#if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 -#define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}" -#else -#define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}" -#endif -#endif // CLUTCHDUMP_DEFAULT_FORMAT - -#ifndef CLUTCHDUMP_DEFAULT_SEP -//! Default item separator for dump. -#define CLUTCHDUMP_DEFAULT_SEP "\n" -#endif // CLUTCHDUMP_DEFAULT_SEP - -#ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK -//! Default mark for stack depth. -#define CLUTCHLOG_DEFAULT_DEPTH_MARK ">" -#endif // CLUTCHLOG_DEFAULT_DEPTH_MARK - #ifndef CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG -//! Default level over which calls to the logger are optimized out when NDEBUG is defined. -#define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress + //! Default level over which calls to the logger are optimized out when NDEBUG is defined. + #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress #endif // CLUTCHLOG_DEFAULT_DEPTH_BUILT -#ifndef CLUTCHLOG_STRIP_CALLS -//! Number of call stack levels to remove from depth display by default. -#define CLUTCHLOG_STRIP_CALLS 5 -#endif // CLUTCHLOG_STRIP_CALLS /** @} */ + /** @addtogroup UseMacros High-level API macros * @{ */ @@ -97,88 +66,87 @@ namespace fs = std::filesystem; //! Log a message at the given level. #ifndef NDEBUG -#define CLUTCHLOG( LEVEL, WHAT ) { \ - auto& clutchlog__logger = clutchlog::logger(); \ - std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \ - clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \ -} -#else // not Debug build. -#define CLUTCHLOG( LEVEL, WHAT ) { \ - if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ - auto& clutchlog__logger = clutchlog::logger(); \ - std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \ + #define CLUTCHLOG( LEVEL, WHAT ) do { \ + auto& clutchlog__logger = clutchlog::logger(); \ + std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \ clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \ - } \ -} + } while(0) +#else // not Debug build. + #define CLUTCHLOG( LEVEL, WHAT ) do { \ + if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ + auto& clutchlog__logger = clutchlog::logger(); \ + std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \ + clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \ + } \ + } while(0) #endif // NDEBUG //! Dump the given container. #ifndef NDEBUG -#define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { \ - auto& clutchlog__logger = clutchlog::logger(); \ - clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \ - CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \ -} -#else // not Debug build. -#define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { \ - if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ - auto& clutchlog__logger = clutchlog::logger(); \ + #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \ + auto& clutchlog__logger = clutchlog::logger(); \ clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \ - CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \ - } \ -} + CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \ + } while(0) +#else // not Debug build. + #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \ + if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ + auto& clutchlog__logger = clutchlog::logger(); \ + clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \ + CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \ + } \ + } while(0) #endif // NDEBUG //! Call any function if the scope matches. #ifndef NDEBUG -#define CLUTCHFUNC( LEVEL, FUNC, ... ) { \ - auto& clutchlog__logger = clutchlog::logger(); \ - clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ - if(clutchlog__scope.matches) { \ - FUNC(__VA_ARGS__); \ - } \ -} -#else // not Debug build. -#define CLUTCHFUNC( LEVEL, FUNC, ... ) { \ - if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ - auto& clutchlog__logger = clutchlog::logger(); \ + #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \ + auto& clutchlog__logger = clutchlog::logger(); \ clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ - if(clutchlog__scope.matches) { \ - FUNC(__VA_ARGS__); \ - } \ - } \ -} + if(clutchlog__scope.matches) { \ + FUNC(__VA_ARGS__); \ + } \ + } while(0) +#else // not Debug build. + #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \ + if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ + auto& clutchlog__logger = clutchlog::logger(); \ + clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ + if(clutchlog__scope.matches) { \ + FUNC(__VA_ARGS__); \ + } \ + } while(0) #endif // NDEBUG //! Run any code if the scope matches. #ifndef NDEBUG -#define CLUTCHCODE( LEVEL, ... ) { \ - auto& clutchlog__logger = clutchlog::logger(); \ - clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ - if(clutchlog__scope.matches) { \ - __VA_ARGS__ \ - } \ -} -#else // not Debug build. -#define CLUTCHCODE( LEVEL, CODE ) { \ - if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ - auto& clutchlog__logger = clutchlog::logger(); \ + #define CLUTCHCODE( LEVEL, ... ) do { \ + auto& clutchlog__logger = clutchlog::logger(); \ clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ - if(clutchlog__scope.matches) { \ - CODE \ - } \ - } \ -} + if(clutchlog__scope.matches) { \ + __VA_ARGS__ \ + } \ + } while(0) +#else // not Debug build. + #define CLUTCHCODE( LEVEL, CODE ) do { \ + if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \ + auto& clutchlog__logger = clutchlog::logger(); \ + clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \ + if(clutchlog__scope.matches) { \ + CODE \ + } \ + } \ + } while(0) #endif // NDEBUG /** @} */ #else // not WITH_CLUTCHLOG -// Disabled macros can still be called in Release builds. -#define CLUTCHLOG( LEVEL, WHAT ) { do {/*nothing*/} while(false); } -#define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { do {/*nothing*/} while(false); } -#define CLUTCHFUNC( LEVEL, FUNC, ... ) { do {/*nothing*/} while(false); } -#define CLUTCHCODE( LEVEL, CODE ) { do {/*nothing*/} while(false); } + // Disabled macros can still be called in Release builds. + #define CLUTCHLOG( LEVEL, WHAT ) do {/*nothing*/} while(0) + #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do {/*nothing*/} while(0) + #define CLUTCHFUNC( LEVEL, FUNC, ... ) do {/*nothing*/} while(0) + #define CLUTCHCODE( LEVEL, CODE ) do {/*nothing*/} while(0) #endif // WITH_CLUTCHLOG /********************************************************************** @@ -195,6 +163,50 @@ namespace fs = std::filesystem; */ class clutchlog { + protected: + + /** @addtogroup UseMacros High-level API macros + * @{ */ + #ifndef CLUTCHLOG_DEFAULT_FORMAT + //! Default format of the messages. + #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 + #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" + #else + #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" + #endif + #endif // CLUTCHLOG_DEFAULT_FORMAT + static inline std::string default_format = CLUTCHLOG_DEFAULT_FORMAT; + + #ifndef CLUTCHDUMP_DEFAULT_FORMAT + //! Default format of the comment line in file dump. + #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 + #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}" + #else + #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}" + #endif + #endif // CLUTCHDUMP_DEFAULT_FORMAT + static inline std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT; + + #ifndef CLUTCHDUMP_DEFAULT_SEP + //! Default item separator for dump. + #define CLUTCHDUMP_DEFAULT_SEP "\n" + #endif // CLUTCHDUMP_DEFAULT_SEP + static inline std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP; + + #ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK + //! Default mark for stack depth. + #define CLUTCHLOG_DEFAULT_DEPTH_MARK ">" + #endif // CLUTCHLOG_DEFAULT_DEPTH_MARK + static inline std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK; + + #ifndef CLUTCHLOG_STRIP_CALLS + //! Number of call stack levels to remove from depth display by default. + #define CLUTCHLOG_STRIP_CALLS 5 + #endif // CLUTCHLOG_STRIP_CALLS + static inline unsigned int strip_calls = CLUTCHLOG_STRIP_CALLS; + /* @} */ + + public: /** @name High-level API * @{ */ @@ -347,7 +359,7 @@ class clutchlog private: clutchlog() : // system, main, log - _strip_calls(CLUTCHLOG_STRIP_CALLS), + _strip_calls(clutchlog::strip_calls), _level_word({ {level::critical,"Critical"}, {level::error ,"Error"}, @@ -368,12 +380,12 @@ class clutchlog {level::debug ,fmt()}, {level::xdebug ,fmt()} }), - _format_log(CLUTCHLOG_DEFAULT_FORMAT), - _format_dump(CLUTCHDUMP_DEFAULT_FORMAT), + _format_log(clutchlog::default_format), + _format_dump(clutchlog::dump_default_format), _out(&std::clog), #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 _depth(std::numeric_limits::max() - _strip_calls), - _depth_mark(CLUTCHLOG_DEFAULT_DEPTH_MARK), + _depth_mark(clutchlog::default_depth_mark), #endif _stage(level::error), _in_file(".*"), @@ -710,8 +722,8 @@ class clutchlog const level& stage, const In container_begin, const In container_end, const std::string& file, const std::string& func, size_t line, - const std::string& filename_template="dump_{n}.dat", - const std::string sep=CLUTCHDUMP_DEFAULT_SEP + const std::string& filename_template = "dump_{n}.dat", + const std::string sep = dump_default_sep ) const { scope_t scope = locate(stage, file, func, line); diff --git a/docs/classclutchlog-members.html b/docs/classclutchlog-members.html index 9c609f6..5c8b8ab 100644 --- a/docs/classclutchlog-members.html +++ b/docs/classclutchlog-members.html @@ -83,38 +83,43 @@ $(function() { clutchlog(clutchlog const &)=delete (defined in clutchlog)clutchlog critical enum value (defined in clutchlog)clutchlog debug enum value (defined in clutchlog)clutchlog - dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=CLUTCHDUMP_DEFAULT_SEP) constclutchloginline + default_depth_mark (defined in clutchlog)clutchloginlineprotectedstatic + default_format (defined in clutchlog)clutchloginlineprotectedstatic + dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) constclutchloginline + dump_default_format (defined in clutchlog)clutchloginlineprotectedstatic + dump_default_sep (defined in clutchlog)clutchloginlineprotectedstatic error enum value (defined in clutchlog)clutchlog - file(std::string file)clutchloginline - format(const std::string &format)clutchloginline - format() constclutchloginline - format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) constclutchloginline - format_comment(const std::string &format)clutchloginline - format_comment() constclutchloginline - func(std::string func)clutchloginline + file(std::string file)clutchloginline + format(const std::string &format)clutchloginline + format() constclutchloginline + format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) constclutchloginline + format_comment(const std::string &format)clutchloginline + format_comment() constclutchloginline + func(std::string func)clutchloginline info enum value (defined in clutchlog)clutchlog - level enum nameclutchlog - level_of(const std::string name)clutchloginline - line(std::string line)clutchloginline - locate(const level &stage, const std::string &file, const std::string &func, const size_t line) constclutchloginline - location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")clutchloginline - log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) constclutchloginline - logger()clutchloginlinestatic + level enum nameclutchlog + level_of(const std::string name)clutchloginline + line(std::string line)clutchloginline + locate(const level &stage, const std::string &file, const std::string &func, const size_t line) constclutchloginline + location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")clutchloginline + log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) constclutchloginline + logger()clutchloginlinestatic max_buffer (defined in clutchlog)clutchlogprotectedstatic note enum value (defined in clutchlog)clutchlog operator=(clutchlog const &)=delete (defined in clutchlog)clutchlog - out(std::ostream &out)clutchloginline - out()clutchloginline + out(std::ostream &out)clutchloginline + out()clutchloginline progress enum value (defined in clutchlog)clutchlog - replace(const std::string &form, const std::string &mark, const std::string &tag) constclutchloginline - replace(const std::string &form, const std::string &mark, const size_t tag) constclutchloginline - style(level stage, FMT... styles)clutchloginline - style(level stage, fmt style)clutchloginline - style(level stage) constclutchloginline - threshold(level l)clutchloginline - threshold() constclutchloginline - warning enum value (defined in clutchlog)clutchlog - xdebug enum value (defined in clutchlog)clutchlog + replace(const std::string &form, const std::string &mark, const std::string &tag) constclutchloginline + replace(const std::string &form, const std::string &mark, const size_t tag) constclutchloginline + strip_calls (defined in clutchlog)clutchloginlineprotectedstatic + style(level stage, FMT... styles)clutchloginline + style(level stage, fmt style)clutchloginline + style(level stage) constclutchloginline + threshold(level l)clutchloginline + threshold() constclutchloginline + warning enum value (defined in clutchlog)clutchlog + xdebug enum value (defined in clutchlog)clutchlog
diff --git a/docs/classclutchlog.html b/docs/classclutchlog.html index 29852e8..9a5d019 100644 --- a/docs/classclutchlog.html +++ b/docs/classclutchlog.html @@ -64,6 +64,7 @@ $(function() {
Classes | +Static Protected Attributes | List of all members
clutchlog Class Reference
Main class
@@ -82,98 +83,116 @@ Classes

Public Member Functions

Configuration accessors
- -void format (const std::string &format) - Set the template string.
-  - -std::string format () const - Get the template string.
-  - -void format_comment (const std::string &format) - Set the template string for dumps.
-  - -std::string format_comment () const - Get the template string for dumps.
-  - -void out (std::ostream &out) - Set the output stream on which to print.
-  - -std::ostream & out () - Get the output stream on which to print.
-  - -void threshold (level l) - Set the log level below which logs are not printed.
-  - -level threshold () const - Get the log level below which logs are not printed.
-  - -void file (std::string file) - Set the regular expression filtering the file location.
-  - -void func (std::string func) - Set the regular expression filtering the function location.
-  - -void line (std::string line) - Set the regular expression filtering the line location.
-  - -void location (const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*") - Set the regular expressions filtering the location.
-  -template<class ... FMT> -void style (level stage, FMT... styles) - Set the style (color and typo) of the given log level. More...
-  - -void style (level stage, fmt style) - Set the style (color and typo) of the given log level, passing a fmt instance.
-  - -fmt style (level stage) const - Get the configured fmt instance of the given log level.
-  -level level_of (const std::string name) - Return the log level tag corresponding to the given pre-configured name. More...
-  + +void format (const std::string &format) + Set the template string.
+  + +std::string format () const + Get the template string.
+  + +void format_comment (const std::string &format) + Set the template string for dumps.
+  + +std::string format_comment () const + Get the template string for dumps.
+  + +void out (std::ostream &out) + Set the output stream on which to print.
+  + +std::ostream & out () + Get the output stream on which to print.
+  + +void threshold (level l) + Set the log level below which logs are not printed.
+  + +level threshold () const + Get the log level below which logs are not printed.
+  + +void file (std::string file) + Set the regular expression filtering the file location.
+  + +void func (std::string func) + Set the regular expression filtering the function location.
+  + +void line (std::string line) + Set the regular expression filtering the line location.
+  + +void location (const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*") + Set the regular expressions filtering the location.
+  +template<class ... FMT> +void style (level stage, FMT... styles) + Set the style (color and typo) of the given log level. More...
+  + +void style (level stage, fmt style) + Set the style (color and typo) of the given log level, passing a fmt instance.
+  + +fmt style (level stage) const + Get the configured fmt instance of the given log level.
+  +level level_of (const std::string name) + Return the log level tag corresponding to the given pre-configured name. More...
+ 
Low-level API
- -scope_t locate (const level &stage, const std::string &file, const std::string &func, const size_t line) const - Gather information on the current location of the call.
-  -std::string replace (const std::string &form, const std::string &mark, const std::string &tag) const - Replace mark by tag in form. More...
-  - -std::string replace (const std::string &form, const std::string &mark, const size_t tag) const - Replace mark by tag in form, converting tag to its string representation first.
-  - -std::string format (std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const - Substitute all tags in the format string with the corresponding information and apply the style corresponding to the log level.
-  - -void log (const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const - Print a log message IF the location matches the given one.
-  - + +scope_t locate (const level &stage, const std::string &file, const std::string &func, const size_t line) const + Gather information on the current location of the call.
+  +std::string replace (const std::string &form, const std::string &mark, const std::string &tag) const + Replace mark by tag in form. More...
+  + +std::string replace (const std::string &form, const std::string &mark, const size_t tag) const + Replace mark by tag in form, converting tag to its string representation first.
+  + +std::string format (std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const + Substitute all tags in the format string with the corresponding information and apply the style corresponding to the log level.
+  + +void log (const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const + Print a log message IF the location matches the given one.
+  + template<class In > -void dump (const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=CLUTCHDUMP_DEFAULT_SEP) const - Dump a serializable container after a comment line with log information.
-  +void dump (const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) const + Dump a serializable container after a comment line with log information.
+  + + + + + + + + + + + +

+Static Protected Attributes

+static std::string default_format = CLUTCHLOG_DEFAULT_FORMAT
 
+static std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
 
+static std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
 
+static std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
 
+static unsigned int strip_calls = CLUTCHLOG_STRIP_CALLS
 
-xdebug =7
} - - - - - + + + + +

High-level API

enum  level {
+
enum  level {
  critical =0, error =1, warning =2, @@ -185,208 +204,61 @@ High-level API
 Available log levels.
 
static clutchlog & logger ()
 Get the logger instance. More...
 
 Available log levels.
 
static clutchlog & logger ()
 Get the logger instance. More...
 
- - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + - - + - +

Internal details

-const size_t _strip_calls
 
-const std::map< level, std::string > _level_word
 
-std::map< std::string, level > _word_level
 
-std::map< level, fmt > _level_fmt
 
-std::string _format_log
 
-std::string _format_dump
 
-std::ostream * _out
 
-level _stage
 
-std::regex _in_file
 
-std::regex _in_func
 
-std::regex _in_line
 
+
static const size_t max_buffer = 4096
 
+
 
+const size_t _strip_calls
 
+const std::map< level, std::string > _level_word
 
+std::map< std::string, level > _word_level
 
+std::map< level, fmt > _level_fmt
 
+std::string _format_log
 
+std::string _format_dump
 
+std::ostream * _out
 
+level _stage
 
+std::regex _in_file
 
+std::regex _in_func
 
+std::regex _in_line
 
 clutchlog (clutchlog const &)=delete
 
+
 
void operator= (clutchlog const &)=delete
 
 
-

Member Function Documentation

- -

◆ level_of()

- -
-
- - - - - -
- - - - - - - - -
level clutchlog::level_of (const std::string name)
- 		-inline
-
- -

Return the log level tag corresponding to the given pre-configured name.

-
Note
This is case sensitive, see the pre-configured _level_word.
- -
-
- -

◆ logger()

- -
-
- - - - - -
- - - - - - - -
static clutchlog& clutchlog::logger ()
- 		-inlinestatic
-
- -

Get the logger instance.

-
auto& log = clutchlog::logger();
-
-
-
- -

◆ replace()

- -
-
- - - - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
std::string clutchlog::replace (const std::string & form,
const std::string & mark,
const std::string & tag 
) const
- 		-inline
-
- -

Replace mark by tag in form.

-
log.replace("{greet} {world}", "\\{greet\\}", "hello");
-
// returns "hello {world}"
-
-
-
- -

◆ style()

- -
-
-
-template<class ... FMT>
- - - - - -
- - - - - - - - - - - - - - - - - - -
void clutchlog::style (level stage,
FMT... styles 
)
- 		-inline
-
- -

Set the style (color and typo) of the given log level.

-

This version accept style arguments as if they were passed to clutchlog::fmt.

- -
-
The documentation for this class was generated from the following file:
-
clutchlog::log
void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
Print a log message IF the location matches the given one.
Definition: clutchlog.h:684
-
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:208
Generated by   diff --git a/docs/classclutchlog_1_1fmt-members.html b/docs/classclutchlog_1_1fmt-members.html index 265b1ed..56f465b 100644 --- a/docs/classclutchlog_1_1fmt-members.html +++ b/docs/classclutchlog_1_1fmt-members.html @@ -74,9 +74,9 @@ $(function() {

This is the complete list of members for clutchlog::fmt, including all inherited members.

- - - + + + @@ -84,11 +84,11 @@ $(function() { - - - + + + - +
back (defined in clutchlog::fmt)clutchlog::fmt
bg enum nameclutchlog::fmt
fg enum nameclutchlog::fmt
fmt()clutchlog::fmtinline
bg enum nameclutchlog::fmt
fg enum nameclutchlog::fmt
fmt()clutchlog::fmtinline
fmt(fg f, bg b=bg::none, typo s=typo::none) (defined in clutchlog::fmt)clutchlog::fmtinline
fmt(fg f, typo s, bg b=bg::none) (defined in clutchlog::fmt)clutchlog::fmtinline
fmt(bg b, fg f=fg::none, typo s=typo::none) (defined in clutchlog::fmt)clutchlog::fmtinline
fmt(typo s, fg f=fg::none, bg b=bg::none) (defined in clutchlog::fmt)clutchlog::fmtinline
fmt(typo s, bg b, fg f=fg::none) (defined in clutchlog::fmt)clutchlog::fmtinline
fore (defined in clutchlog::fmt)clutchlog::fmt
operator()(const std::string &msg) constclutchlog::fmtinline
operator<<(std::ostream &os, const fmt &fmt)clutchlog::fmtfriend
print_on(std::ostream &os) constclutchlog::fmtinlineprotected
operator()(const std::string &msg) constclutchlog::fmtinline
operator<<(std::ostream &os, const fmt &fmt)clutchlog::fmtfriend
print_on(std::ostream &os) constclutchlog::fmtinlineprotected
style (defined in clutchlog::fmt)clutchlog::fmt
typo enum nameclutchlog::fmt
typo enum nameclutchlog::fmt
diff --git a/docs/classclutchlog_1_1fmt.html b/docs/classclutchlog_1_1fmt.html index 78ade49..db0d749 100644 --- a/docs/classclutchlog_1_1fmt.html +++ b/docs/classclutchlog_1_1fmt.html @@ -74,7 +74,7 @@ $(function() { Friends | List of all members
-
clutchlog::fmt Class Reference
Formating tools
+
clutchlog::fmt Class Reference
High-level API macros » Formating tools
@@ -85,7 +85,7 @@ $(function() { -   none
} - - - + +   none
} - - - + +   none
} - - + +

Public Types

enum  fg {
+
enum  fg {
  black = 30, red = 31, green = 32, @@ -99,9 +99,9 @@ Public Types
 Foreground color codes.
 
enum  bg {
+
 Foreground color codes.
 
enum  bg {
  black = 40, red = 41, green = 42, @@ -115,9 +115,9 @@ Public Types
 Background color codes.
 
enum  typo {
+
 Background color codes.
 
enum  typo {
  reset = 0, bold = 1, underline = 4, @@ -126,146 +126,70 @@ Public Types
 Typographic style codes.
 
 Typographic style codes.
 
- - - - - - + + + + + + - - - - - - - - - - - - + + + + + + + + + + + +

Public Member Functions

- fmt ()
  Empty constructor, only useful for a no-op formatter.
 
std::string operator() (const std::string &msg) const
 Format the given string with the currently encoded format. More...
 
+ fmt ()
  Empty constructor, only useful for a no-op formatter.
 
std::string operator() (const std::string &msg) const
 Format the given string with the currently encoded format. More...
 
All combination of constructors with different parameters orders.
- fmt (fg f, bg b=bg::none, typo s=typo::none)
 
- fmt (fg f, typo s, bg b=bg::none)
 
- fmt (bg b, fg f=fg::none, typo s=typo::none)
 
- fmt (bg b, typo s, fg f=fg::none)
 
- fmt (typo s, fg f=fg::none, bg b=bg::none)
 
- fmt (typo s, bg b, fg f=fg::none)
 
+ fmt (fg f, bg b=bg::none, typo s=typo::none)
 
+ fmt (fg f, typo s, bg b=bg::none)
 
+ fmt (bg b, fg f=fg::none, typo s=typo::none)
 
+ fmt (bg b, typo s, fg f=fg::none)
 
+ fmt (typo s, fg f=fg::none, bg b=bg::none)
 
+ fmt (typo s, bg b, fg f=fg::none)
 
- - - - - - + + + + + +

Public Attributes

-enum clutchlog::fmt::fg fore
 
-enum clutchlog::fmt::bg back
 
-enum clutchlog::fmt::typo style
 
+enum clutchlog::fmt::fg fore
 
+enum clutchlog::fmt::bg back
 
+enum clutchlog::fmt::typo style
 
- - - + + +

Protected Member Functions

-std::ostream & print_on (std::ostream &os) const
 Print the currently encoded format escape code on the given output stream.
 
+std::ostream & print_on (std::ostream &os) const
 Print the currently encoded format escape code on the given output stream.
 
- - - + + +

Friends

std::ostream & operator<< (std::ostream &os, const fmt &fmt)
 Output stream overload. More...
 
std::ostream & operator<< (std::ostream &os, const fmt &fmt)
 Output stream overload. More...
 

Detailed Description

Color and style formatter for ANSI terminal escape sequences.

Note
All styles may not be supported by a given terminal/operating system.
-

Member Function Documentation

- -

◆ operator()()

- -
-
- - - - - -
- - - - - - - - -
std::string clutchlog::fmt::operator() (const std::string & msg) const
- 		-inline
-
- -

Format the given string with the currently encoded format.

-

Allow to use a formatter as a function:

clutchlog::fmt error(clutchlog::fmt::fg::red, clutchlog::fmt::typo::bold);
-
std::cout << error("ERROR") << std::endl;
-
Note
A formatter called this way WILL output a reset escape code at the end.
- -
-
-

Friends And Related Function Documentation

- -

◆ operator<<

- -
-
- - - - - -
- - - - - - - - - - - - - - - - - - -
std::ostream& operator<< (std::ostream & os,
const fmt & fmt 
)
- 		-friend
-
- -

Output stream overload.

-

Allow to use a formatter as a tag within a stream:

clutchlog::fmt end(clutchlog::fmt::typo::reset);
-
clutchlog::fmt error(clutchlog::fmt::fg::red, clutchlog::fmt::typo::bold);
-
std::cout << error << "ERROR" << end << std::endl;
-
Note
An formatter called this way will NOT output a reset escape code.
- -
-
-
The documentation for this class was generated from the following file:
    +
The documentation for this class was generated from the following file: -
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:229
Generated by   diff --git a/docs/clutchlog_8h.html b/docs/clutchlog_8h.html index 62a7068..0c4820d 100644 --- a/docs/clutchlog_8h.html +++ b/docs/clutchlog_8h.html @@ -126,30 +126,10 @@ Macros #define WITH_CLUTCHLOG  Actually enable clutchlog features.
  - -#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" - Default format of the messages.
-  - -#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}" - Default format of the comment line in file dump.
-  - -#define CLUTCHDUMP_DEFAULT_SEP   "\n" - Default item separator for dump.
-  - -#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">" - Default mark for stack depth.
-  #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG   clutchlog::level::progress  Default level over which calls to the logger are optimized out when NDEBUG is defined.
  - -#define CLUTCHLOG_STRIP_CALLS   5 - Number of call stack levels to remove from depth display by default.
-  #define CLUTCHLOC   __FILE__, __FUNCTION__, __LINE__  Handy shortcuts to location.
@@ -166,6 +146,26 @@ Macros #define CLUTCHCODE(LEVEL, ...)  Run any code if the scope matches. More...
  + +#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" + Default format of the messages.
+  + +#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}" + Default format of the comment line in file dump.
+  + +#define CLUTCHDUMP_DEFAULT_SEP   "\n" + Default item separator for dump.
+  + +#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">" + Default mark for stack depth.
+  + +#define CLUTCHLOG_STRIP_CALLS   5 + Number of call stack levels to remove from depth display by default.
+  diff --git a/docs/clutchlog_8h_source.html b/docs/clutchlog_8h_source.html index 17dd412..1758367 100644 --- a/docs/clutchlog_8h_source.html +++ b/docs/clutchlog_8h_source.html @@ -75,12 +75,12 @@ $(function() {
3 #pragma once
4 
6 #include <ciso646>
-
7 #ifdef FSEXPERIMENTAL
-
8 #include <experimental/filesystem>
-
9 namespace fs = std::experimental::filesystem;
+
7  #ifdef FSEXPERIMENTAL
+
8  #include <experimental/filesystem>
+
9  namespace fs = std::experimental::filesystem;
10 #else
-
11 #include <filesystem>
-
12 namespace fs = std::filesystem;
+
11  #include <filesystem>
+
12  namespace fs = std::filesystem;
13 #endif
14 
15 #include <iostream>
@@ -94,21 +94,21 @@ $(function() {
23 #include <map>
24 
25 #if __has_include(<execinfo.h>) && __has_include(<stdlib.h>) && __has_include(<libgen.h>)
-
26 #include <execinfo.h> // execinfo
-
27 #include <stdlib.h> // getenv
-
28 #include <libgen.h> // basename
-
30 #define CLUTCHLOG_HAVE_UNIX_SYSINFO 1
+
26  #include <execinfo.h> // execinfo
+
27  #include <stdlib.h> // getenv
+
28  #include <libgen.h> // basename
+
30  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 1
31 #else
-
32 #define CLUTCHLOG_HAVE_UNIX_SYSINFO 0
+
32  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 0
33 #endif
34 
35 /**********************************************************************
36  * Enable by default in Debug builds.
37  **********************************************************************/
38 #ifndef WITH_CLUTCHLOG
-
39 #ifndef NDEBUG
-
40 #define WITH_CLUTCHLOG
-
42 #endif
+
39  #ifndef NDEBUG
+
40  #define WITH_CLUTCHLOG
+
42  #endif
43 #endif
44 
45 /**********************************************************************
@@ -116,762 +116,770 @@ $(function() {
47  **********************************************************************/
48 #ifdef WITH_CLUTCHLOG
49 
-
53 #ifndef CLUTCHLOG_DEFAULT_FORMAT
-
54 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
56 #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
-
57 #else
-
58 #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
-
59 #endif
-
60 #endif // CLUTCHLOG_DEFAULT_FORMAT
-
61 
-
62 #ifndef CLUTCHDUMP_DEFAULT_FORMAT
-
63 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
65 #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}"
-
66 #else
-
67 #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}"
-
68 #endif
-
69 #endif // CLUTCHDUMP_DEFAULT_FORMAT
-
70 
-
71 #ifndef CLUTCHDUMP_DEFAULT_SEP
-
72 #define CLUTCHDUMP_DEFAULT_SEP "\n"
-
74 #endif // CLUTCHDUMP_DEFAULT_SEP
-
75 
-
76 #ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK
-
77 #define CLUTCHLOG_DEFAULT_DEPTH_MARK ">"
-
79 #endif // CLUTCHLOG_DEFAULT_DEPTH_MARK
-
80 
-
81 #ifndef CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG
-
82 #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress
-
84 #endif // CLUTCHLOG_DEFAULT_DEPTH_BUILT
-
85 
-
86 #ifndef CLUTCHLOG_STRIP_CALLS
-
87 #define CLUTCHLOG_STRIP_CALLS 5
-
89 #endif // CLUTCHLOG_STRIP_CALLS
-
90 
-
95 #define CLUTCHLOC __FILE__, __FUNCTION__, __LINE__
-
97 
-
99 #ifndef NDEBUG
-
100 #define CLUTCHLOG( LEVEL, WHAT ) { \
-
101  auto& clutchlog__logger = clutchlog::logger(); \
-
102  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
-
103  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
-
104 }
-
105 #else // not Debug build.
-
106 #define CLUTCHLOG( LEVEL, WHAT ) { \
-
107  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
108  auto& clutchlog__logger = clutchlog::logger(); \
-
109  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
-
110  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
-
111  } \
-
112 }
-
113 #endif // NDEBUG
-
114 
-
116 #ifndef NDEBUG
-
117 #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { \
-
118  auto& clutchlog__logger = clutchlog::logger(); \
-
119  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
-
120  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
-
121 }
-
122 #else // not Debug build.
-
123 #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { \
-
124  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
125  auto& clutchlog__logger = clutchlog::logger(); \
-
126  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
-
127  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
-
128  } \
-
129 }
-
130 #endif // NDEBUG
-
131 
-
133 #ifndef NDEBUG
-
134 #define CLUTCHFUNC( LEVEL, FUNC, ... ) { \
-
135  auto& clutchlog__logger = clutchlog::logger(); \
-
136  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
137  if(clutchlog__scope.matches) { \
-
138  FUNC(__VA_ARGS__); \
-
139  } \
-
140 }
-
141 #else // not Debug build.
-
142 #define CLUTCHFUNC( LEVEL, FUNC, ... ) { \
-
143  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
144  auto& clutchlog__logger = clutchlog::logger(); \
-
145  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
146  if(clutchlog__scope.matches) { \
-
147  FUNC(__VA_ARGS__); \
-
148  } \
-
149  } \
-
150 }
-
151 #endif // NDEBUG
-
152 
-
154 #ifndef NDEBUG
-
155 #define CLUTCHCODE( LEVEL, ... ) { \
-
156  auto& clutchlog__logger = clutchlog::logger(); \
-
157  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
158  if(clutchlog__scope.matches) { \
-
159  __VA_ARGS__ \
-
160  } \
-
161 }
-
162 #else // not Debug build.
-
163 #define CLUTCHCODE( LEVEL, CODE ) { \
-
164  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
165  auto& clutchlog__logger = clutchlog::logger(); \
-
166  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
167  if(clutchlog__scope.matches) { \
-
168  CODE \
-
169  } \
-
170  } \
-
171 }
-
172 #endif // NDEBUG
-
173 
-
176 #else // not WITH_CLUTCHLOG
-
177 // Disabled macros can still be called in Release builds.
-
178 #define CLUTCHLOG( LEVEL, WHAT ) { do {/*nothing*/} while(false); }
-
179 #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) { do {/*nothing*/} while(false); }
-
180 #define CLUTCHFUNC( LEVEL, FUNC, ... ) { do {/*nothing*/} while(false); }
-
181 #define CLUTCHCODE( LEVEL, CODE ) { do {/*nothing*/} while(false); }
-
182 #endif // WITH_CLUTCHLOG
-
183 
-
184 /**********************************************************************
-
185  * Implementation
-
186  **********************************************************************/
-
187 
-
188 #ifdef WITH_CLUTCHLOG
+
53 #ifndef CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG
+
54  #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress
+
56 #endif // CLUTCHLOG_DEFAULT_DEPTH_BUILT
+
57 
+
64 #define CLUTCHLOC __FILE__, __FUNCTION__, __LINE__
+
66 
+
68 #ifndef NDEBUG
+
69  #define CLUTCHLOG( LEVEL, WHAT ) do { \
+
70  auto& clutchlog__logger = clutchlog::logger(); \
+
71  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
+
72  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
+
73  } while(0)
+
74 #else // not Debug build.
+
75  #define CLUTCHLOG( LEVEL, WHAT ) do { \
+
76  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
77  auto& clutchlog__logger = clutchlog::logger(); \
+
78  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
+
79  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
+
80  } \
+
81  } while(0)
+
82 #endif // NDEBUG
+
83 
+
85 #ifndef NDEBUG
+
86  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
+
87  auto& clutchlog__logger = clutchlog::logger(); \
+
88  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
+
89  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
+
90  } while(0)
+
91 #else // not Debug build.
+
92  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
+
93  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
94  auto& clutchlog__logger = clutchlog::logger(); \
+
95  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
+
96  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
+
97  } \
+
98  } while(0)
+
99 #endif // NDEBUG
+
100 
+
102 #ifndef NDEBUG
+
103  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
+
104  auto& clutchlog__logger = clutchlog::logger(); \
+
105  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
106  if(clutchlog__scope.matches) { \
+
107  FUNC(__VA_ARGS__); \
+
108  } \
+
109  } while(0)
+
110 #else // not Debug build.
+
111  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
+
112  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
113  auto& clutchlog__logger = clutchlog::logger(); \
+
114  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
115  if(clutchlog__scope.matches) { \
+
116  FUNC(__VA_ARGS__); \
+
117  } \
+
118  } while(0)
+
119 #endif // NDEBUG
+
120 
+
122 #ifndef NDEBUG
+
123  #define CLUTCHCODE( LEVEL, ... ) do { \
+
124  auto& clutchlog__logger = clutchlog::logger(); \
+
125  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
126  if(clutchlog__scope.matches) { \
+
127  __VA_ARGS__ \
+
128  } \
+
129  } while(0)
+
130 #else // not Debug build.
+
131  #define CLUTCHCODE( LEVEL, CODE ) do { \
+
132  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
133  auto& clutchlog__logger = clutchlog::logger(); \
+
134  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
135  if(clutchlog__scope.matches) { \
+
136  CODE \
+
137  } \
+
138  } \
+
139  } while(0)
+
140 #endif // NDEBUG
+
141 
+
144 #else // not WITH_CLUTCHLOG
+
145  // Disabled macros can still be called in Release builds.
+
146  #define CLUTCHLOG( LEVEL, WHAT ) do {/*nothing*/} while(0)
+
147  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do {/*nothing*/} while(0)
+
148  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do {/*nothing*/} while(0)
+
149  #define CLUTCHCODE( LEVEL, CODE ) do {/*nothing*/} while(0)
+
150 #endif // WITH_CLUTCHLOG
+
151 
+
152 /**********************************************************************
+
153  * Implementation
+
154  **********************************************************************/
+
155 
+
156 #ifdef WITH_CLUTCHLOG
+
157 
+
164 class clutchlog
+
165 {
+
166  protected:
+
167 
+
170  #ifndef CLUTCHLOG_DEFAULT_FORMAT
+
171  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
173  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
+
174  #else
+
175  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
+
176  #endif
+
177  #endif // CLUTCHLOG_DEFAULT_FORMAT
+
178  static inline std::string default_format = CLUTCHLOG_DEFAULT_FORMAT;
+
179 
+
180  #ifndef CLUTCHDUMP_DEFAULT_FORMAT
+
181  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
183  #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}"
+
184  #else
+
185  #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}"
+
186  #endif
+
187  #endif // CLUTCHDUMP_DEFAULT_FORMAT
+
188  static inline std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT;
189 
-
196 class clutchlog
-
197 {
-
198  public:
-
208  static clutchlog& logger()
-
209  {
-
210  static clutchlog instance;
-
211  return instance;
-
212  }
-
213 
-
215  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
-
216 
-
229  class fmt {
-
230  public:
-
232  enum class fg {
-
233  black = 30,
-
234  red = 31,
-
235  green = 32,
-
236  yellow = 33,
-
237  blue = 34,
-
238  magenta = 35,
-
239  cyan = 36,
-
240  white = 37,
-
241  none
-
242  } fore;
-
243 
-
245  enum class bg {
-
246  black = 40,
-
247  red = 41,
-
248  green = 42,
-
249  yellow = 43,
-
250  blue = 44,
-
251  magenta = 45,
-
252  cyan = 46,
-
253  white = 47,
-
254  none
-
255  } back;
-
256 
-
258  enum class typo {
-
259  reset = 0,
-
260  bold = 1,
-
261  underline = 4,
-
262  inverse = 7,
-
263  none
-
264  } style;
-
265 
-
267  fmt() : fore(fg::none), back(bg::none), style(typo::none) { }
+
190  #ifndef CLUTCHDUMP_DEFAULT_SEP
+
191  #define CLUTCHDUMP_DEFAULT_SEP "\n"
+
193  #endif // CLUTCHDUMP_DEFAULT_SEP
+
194  static inline std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP;
+
195 
+
196  #ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK
+
197  #define CLUTCHLOG_DEFAULT_DEPTH_MARK ">"
+
199  #endif // CLUTCHLOG_DEFAULT_DEPTH_MARK
+
200  static inline std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK;
+
201 
+
202  #ifndef CLUTCHLOG_STRIP_CALLS
+
203  #define CLUTCHLOG_STRIP_CALLS 5
+
205  #endif // CLUTCHLOG_STRIP_CALLS
+
206  static inline unsigned int strip_calls = CLUTCHLOG_STRIP_CALLS;
+
207  /* @} */
+
208 
+
209 
+
210  public:
+
220  static clutchlog& logger()
+
221  {
+
222  static clutchlog instance;
+
223  return instance;
+
224  }
+
225 
+
227  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
+
228 
+
241  class fmt {
+
242  public:
+
244  enum class fg {
+
245  black = 30,
+
246  red = 31,
+
247  green = 32,
+
248  yellow = 33,
+
249  blue = 34,
+
250  magenta = 35,
+
251  cyan = 36,
+
252  white = 37,
+
253  none
+
254  } fore;
+
255 
+
257  enum class bg {
+
258  black = 40,
+
259  red = 41,
+
260  green = 42,
+
261  yellow = 43,
+
262  blue = 44,
+
263  magenta = 45,
+
264  cyan = 46,
+
265  white = 47,
+
266  none
+
267  } back;
268 
-
271  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
-
272  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) { }
-
273  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
-
274  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) { }
-
275  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) { }
-
276  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) { }
-
279  protected:
-
281  std::ostream& print_on( std::ostream& os) const
-
282  {
-
283  std::vector<int> codes; codes.reserve(3);
-
284  if(this->fore != fg::none) { codes.push_back(static_cast<int>(this->fore ));}
-
285  if(this->back != bg::none) { codes.push_back(static_cast<int>(this->back ));}
-
286  if(this->style != typo::none) { codes.push_back(static_cast<int>(this->style));}
-
287  if(codes.size() == 0) {return os;}
-
288 
-
289  os << "\033[";
-
290  assert(codes.size() > 0);
-
291  os << codes[0];
-
292  for(size_t i=1; i < codes.size(); ++i) {
-
293  os << ";" << codes[i];
-
294  }
-
295  os << "m";
-
296  return os;
-
297  }
-
298 
-
299  public:
-
311  friend std::ostream& operator<<(std::ostream& os, const fmt& fmt)
-
312  {
-
313  return fmt.print_on(os);
-
314  }
-
315 
-
326  std::string operator()( const std::string& msg ) const
-
327  {
-
328  std::ostringstream os;
-
329  this->print_on(os);
-
330  fmt reset(fmt::typo::reset);
-
331  os << msg;
-
332  reset.print_on(os);
-
333  return os.str();
-
334  }
-
335  }; // fmt class
-
336 
-
343  public:
-
344  clutchlog(clutchlog const&) = delete;
-
345  void operator=(clutchlog const&) = delete;
-
346 
-
347  private:
-
348  clutchlog() :
-
349  // system, main, log
-
350  _strip_calls(CLUTCHLOG_STRIP_CALLS),
-
351  _level_word({
-
352  {level::critical,"Critical"},
-
353  {level::error ,"Error"},
-
354  {level::warning ,"Warning"},
-
355  {level::progress,"Progress"},
-
356  {level::note ,"Note"},
-
357  {level::info ,"Info"},
-
358  {level::debug ,"Debug"},
-
359  {level::xdebug ,"XDebug"}
-
360  }),
-
361  _level_fmt({
-
362  {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
-
363  {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
-
364  {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
-
365  {level::progress,fmt()},
-
366  {level::note ,fmt()},
-
367  {level::info ,fmt()},
-
368  {level::debug ,fmt()},
-
369  {level::xdebug ,fmt()}
-
370  }),
-
371  _format_log(CLUTCHLOG_DEFAULT_FORMAT),
-
372  _format_dump(CLUTCHDUMP_DEFAULT_FORMAT),
-
373  _out(&std::clog),
-
374 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
375  _depth(std::numeric_limits<size_t>::max() - _strip_calls),
-
376  _depth_mark(CLUTCHLOG_DEFAULT_DEPTH_MARK),
-
377 #endif
-
378  _stage(level::error),
-
379  _in_file(".*"),
-
380  _in_func(".*"),
-
381  _in_line(".*")
-
382  {
-
383  // Reverse the level->word map into a word->level map.
-
384  for(auto& lw : _level_word) {
-
385  _word_level[lw.second] = lw.first;
-
386  }
-
387  }
-
388 
-
389  protected:
-
390  const size_t _strip_calls;
-
391  const std::map<level,std::string> _level_word;
-
392  std::map<std::string,level> _word_level;
-
393  std::map<level,fmt> _level_fmt;
-
394  std::string _format_log;
-
395  std::string _format_dump;
-
396  std::ostream* _out;
-
397 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
398  size_t _depth;
-
399  std::string _depth_mark;
-
400 #endif
-
401  level _stage;
-
402  std::regex _in_file;
-
403  std::regex _in_func;
-
404  std::regex _in_line;
-
405 
-
406  static const size_t max_buffer = 4096;
-
409  public:
-
410 
-
414  void format(const std::string& format) {_format_log = format;}
-
417  std::string format() const {return _format_log;}
-
418 
-
420  void format_comment(const std::string& format) {_format_dump = format;}
-
422  std::string format_comment() const {return _format_dump;}
-
423 
-
425  void out(std::ostream& out) {_out = &out;}
-
427  std::ostream& out() {return *_out;}
-
428 
-
429 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
430  void depth(size_t d) {_depth = d;}
-
433  size_t depth() const {return _depth;}
-
434 
-
436  void depth_mark(std::string mark) {_depth_mark = mark;}
-
438  std::string depth_mark() const {return _depth_mark;}
-
439 #endif
+
270  enum class typo {
+
271  reset = 0,
+
272  bold = 1,
+
273  underline = 4,
+
274  inverse = 7,
+
275  none
+
276  } style;
+
277 
+
279  fmt() : fore(fg::none), back(bg::none), style(typo::none) { }
+
280 
+
283  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
+
284  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) { }
+
285  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
+
286  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) { }
+
287  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) { }
+
288  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) { }
+
291  protected:
+
293  std::ostream& print_on( std::ostream& os) const
+
294  {
+
295  std::vector<int> codes; codes.reserve(3);
+
296  if(this->fore != fg::none) { codes.push_back(static_cast<int>(this->fore ));}
+
297  if(this->back != bg::none) { codes.push_back(static_cast<int>(this->back ));}
+
298  if(this->style != typo::none) { codes.push_back(static_cast<int>(this->style));}
+
299  if(codes.size() == 0) {return os;}
+
300 
+
301  os << "\033[";
+
302  assert(codes.size() > 0);
+
303  os << codes[0];
+
304  for(size_t i=1; i < codes.size(); ++i) {
+
305  os << ";" << codes[i];
+
306  }
+
307  os << "m";
+
308  return os;
+
309  }
+
310 
+
311  public:
+
323  friend std::ostream& operator<<(std::ostream& os, const fmt& fmt)
+
324  {
+
325  return fmt.print_on(os);
+
326  }
+
327 
+
338  std::string operator()( const std::string& msg ) const
+
339  {
+
340  std::ostringstream os;
+
341  this->print_on(os);
+
342  fmt reset(fmt::typo::reset);
+
343  os << msg;
+
344  reset.print_on(os);
+
345  return os.str();
+
346  }
+
347  }; // fmt class
+
348 
+
355  public:
+
356  clutchlog(clutchlog const&) = delete;
+
357  void operator=(clutchlog const&) = delete;
+
358 
+
359  private:
+
360  clutchlog() :
+
361  // system, main, log
+
362  _strip_calls(clutchlog::strip_calls),
+
363  _level_word({
+
364  {level::critical,"Critical"},
+
365  {level::error ,"Error"},
+
366  {level::warning ,"Warning"},
+
367  {level::progress,"Progress"},
+
368  {level::note ,"Note"},
+
369  {level::info ,"Info"},
+
370  {level::debug ,"Debug"},
+
371  {level::xdebug ,"XDebug"}
+
372  }),
+
373  _level_fmt({
+
374  {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
+
375  {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
+
376  {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
+
377  {level::progress,fmt()},
+
378  {level::note ,fmt()},
+
379  {level::info ,fmt()},
+
380  {level::debug ,fmt()},
+
381  {level::xdebug ,fmt()}
+
382  }),
+
383  _format_log(clutchlog::default_format),
+
384  _format_dump(clutchlog::dump_default_format),
+
385  _out(&std::clog),
+
386 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
387  _depth(std::numeric_limits<size_t>::max() - _strip_calls),
+
388  _depth_mark(clutchlog::default_depth_mark),
+
389 #endif
+
390  _stage(level::error),
+
391  _in_file(".*"),
+
392  _in_func(".*"),
+
393  _in_line(".*")
+
394  {
+
395  // Reverse the level->word map into a word->level map.
+
396  for(auto& lw : _level_word) {
+
397  _word_level[lw.second] = lw.first;
+
398  }
+
399  }
+
400 
+
401  protected:
+
402  const size_t _strip_calls;
+
403  const std::map<level,std::string> _level_word;
+
404  std::map<std::string,level> _word_level;
+
405  std::map<level,fmt> _level_fmt;
+
406  std::string _format_log;
+
407  std::string _format_dump;
+
408  std::ostream* _out;
+
409 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
410  size_t _depth;
+
411  std::string _depth_mark;
+
412 #endif
+
413  level _stage;
+
414  std::regex _in_file;
+
415  std::regex _in_func;
+
416  std::regex _in_line;
+
417 
+
418  static const size_t max_buffer = 4096;
+
421  public:
+
422 
+
426  void format(const std::string& format) {_format_log = format;}
+
429  std::string format() const {return _format_log;}
+
430 
+
432  void format_comment(const std::string& format) {_format_dump = format;}
+
434  std::string format_comment() const {return _format_dump;}
+
435 
+
437  void out(std::ostream& out) {_out = &out;}
+
439  std::ostream& out() {return *_out;}
440 
-
442  void threshold(level l) {_stage = l;}
-
444  level threshold() const {return _stage;}
-
445 
-
447  void file(std::string file) {_in_file = file;}
-
449  void func(std::string func) {_in_func = func;}
-
451  void line(std::string line) {_in_line = line;}
+
441 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
442  void depth(size_t d) {_depth = d;}
+
445  size_t depth() const {return _depth;}
+
446 
+
448  void depth_mark(std::string mark) {_depth_mark = mark;}
+
450  std::string depth_mark() const {return _depth_mark;}
+
451 #endif
452 
-
454  void location(
-
455  const std::string& in_file,
-
456  const std::string& in_function=".*",
-
457  const std::string& in_line=".*"
-
458  )
-
459  {
-
460  file(in_file);
-
461  func(in_function);
-
462  line(in_line);
-
463  }
+
454  void threshold(level l) {_stage = l;}
+
456  level threshold() const {return _stage;}
+
457 
+
459  void file(std::string file) {_in_file = file;}
+
461  void func(std::string func) {_in_func = func;}
+
463  void line(std::string line) {_in_line = line;}
464 
-
469  template<class ... FMT>
-
470  void style(level stage, FMT... styles) { this->style(stage,fmt(styles...)); }
-
472  void style(level stage, fmt style) { _level_fmt.at(stage) = style; }
-
474  fmt style(level stage) const { return _level_fmt.at(stage); }
-
475 
-
480  level level_of(const std::string name)
-
481  {
-
482  const auto ilevel = _word_level.find(name);
-
483  if( ilevel != std::end(_word_level)) {
-
484  return ilevel->second;
-
485  } else {
-
486  throw std::out_of_range("'" + name + "' is not a valid log level name");
-
487  }
-
488  }
-
489 
-
492  public:
-
493 
-
497  struct scope_t {
-
499  bool matches; // everything is compatible
-
500  level stage; // current log level
-
501 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
502  size_t depth; // current depth
-
503 #endif
-
504  bool there; // location is compatible
-
505  scope_t() :
-
506  matches(false),
-
507  stage(level::xdebug),
-
508 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
509  depth(0),
-
510 #endif
-
511  there(false)
-
512  {}
-
513  }; // scope_t
-
514 
-
515 
-
517  scope_t locate(
-
518  const level& stage,
-
519  const std::string& file,
-
520  const std::string& func,
-
521  const size_t line
-
522  ) const
-
523  {
-
524  scope_t scope; // False scope by default.
-
525 
-
526  /***** Log level stage *****/
-
527  // Test stage first, because it's fastest.
-
528  scope.stage = stage;
-
529  if(not (scope.stage <= _stage)) {
-
530  // Bypass useless computations if no match
-
531  // because of the stage.
-
532  return scope;
-
533  }
-
534 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
535  /***** Stack depth *****/
-
536  // Backtrace in second, quite fast.
-
537  size_t stack_depth;
-
538  void *buffer[max_buffer];
-
539  stack_depth = backtrace(buffer, max_buffer);
-
540  scope.depth = stack_depth;
-
541  if(not (scope.depth <= _depth + _strip_calls)) {
-
542  // Bypass if no match.
-
543  return scope;
-
544  }
-
545 #endif
-
546 
-
547  /***** Location *****/
-
548  // Location last, slowest.
-
549  std::ostringstream sline; sline << line;
-
550  scope.there =
-
551  std::regex_search(file, _in_file)
-
552  and std::regex_search(func, _in_func)
-
553  and std::regex_search(sline.str(), _in_line);
-
554 
-
555  // No need to retest stage and depth, which are true here.
-
556  scope.matches = scope.there;
-
557 
-
558  return scope;
-
559  } // locate
-
560 
-
568  std::string replace(
-
569  const std::string& form,
-
570  const std::string& mark,
-
571  const std::string& tag
-
572  ) const
-
573  {
-
574  // Useless debug code, unless something fancy would be done with name tags.
-
575  // std::regex re;
-
576  // try {
-
577  // re = std::regex(mark);
-
578  //
-
579  // } catch(const std::regex_error& e) {
-
580  // std::cerr << "ERROR with a regular expression \"" << mark << "\": ";
-
581  // switch(e.code()) {
-
582  // case std::regex_constants::error_collate:
-
583  // std::cerr << "the expression contains an invalid collating element name";
-
584  // break;
-
585  // case std::regex_constants::error_ctype:
-
586  // std::cerr << "the expression contains an invalid character class name";
-
587  // break;
-
588  // case std::regex_constants::error_escape:
-
589  // std::cerr << "the expression contains an invalid escaped character or a trailing escape";
-
590  // break;
-
591  // case std::regex_constants::error_backref:
-
592  // std::cerr << "the expression contains an invalid back reference";
-
593  // break;
-
594  // case std::regex_constants::error_brack:
-
595  // std::cerr << "the expression contains mismatched square brackets ('[' and ']')";
+
466  void location(
+
467  const std::string& in_file,
+
468  const std::string& in_function=".*",
+
469  const std::string& in_line=".*"
+
470  )
+
471  {
+
472  file(in_file);
+
473  func(in_function);
+
474  line(in_line);
+
475  }
+
476 
+
481  template<class ... FMT>
+
482  void style(level stage, FMT... styles) { this->style(stage,fmt(styles...)); }
+
484  void style(level stage, fmt style) { _level_fmt.at(stage) = style; }
+
486  fmt style(level stage) const { return _level_fmt.at(stage); }
+
487 
+
492  level level_of(const std::string name)
+
493  {
+
494  const auto ilevel = _word_level.find(name);
+
495  if( ilevel != std::end(_word_level)) {
+
496  return ilevel->second;
+
497  } else {
+
498  throw std::out_of_range("'" + name + "' is not a valid log level name");
+
499  }
+
500  }
+
501 
+
504  public:
+
505 
+
509  struct scope_t {
+
511  bool matches; // everything is compatible
+
512  level stage; // current log level
+
513 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
514  size_t depth; // current depth
+
515 #endif
+
516  bool there; // location is compatible
+
517  scope_t() :
+
518  matches(false),
+
519  stage(level::xdebug),
+
520 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
521  depth(0),
+
522 #endif
+
523  there(false)
+
524  {}
+
525  }; // scope_t
+
526 
+
527 
+
529  scope_t locate(
+
530  const level& stage,
+
531  const std::string& file,
+
532  const std::string& func,
+
533  const size_t line
+
534  ) const
+
535  {
+
536  scope_t scope; // False scope by default.
+
537 
+
538  /***** Log level stage *****/
+
539  // Test stage first, because it's fastest.
+
540  scope.stage = stage;
+
541  if(not (scope.stage <= _stage)) {
+
542  // Bypass useless computations if no match
+
543  // because of the stage.
+
544  return scope;
+
545  }
+
546 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
547  /***** Stack depth *****/
+
548  // Backtrace in second, quite fast.
+
549  size_t stack_depth;
+
550  void *buffer[max_buffer];
+
551  stack_depth = backtrace(buffer, max_buffer);
+
552  scope.depth = stack_depth;
+
553  if(not (scope.depth <= _depth + _strip_calls)) {
+
554  // Bypass if no match.
+
555  return scope;
+
556  }
+
557 #endif
+
558 
+
559  /***** Location *****/
+
560  // Location last, slowest.
+
561  std::ostringstream sline; sline << line;
+
562  scope.there =
+
563  std::regex_search(file, _in_file)
+
564  and std::regex_search(func, _in_func)
+
565  and std::regex_search(sline.str(), _in_line);
+
566 
+
567  // No need to retest stage and depth, which are true here.
+
568  scope.matches = scope.there;
+
569 
+
570  return scope;
+
571  } // locate
+
572 
+
580  std::string replace(
+
581  const std::string& form,
+
582  const std::string& mark,
+
583  const std::string& tag
+
584  ) const
+
585  {
+
586  // Useless debug code, unless something fancy would be done with name tags.
+
587  // std::regex re;
+
588  // try {
+
589  // re = std::regex(mark);
+
590  //
+
591  // } catch(const std::regex_error& e) {
+
592  // std::cerr << "ERROR with a regular expression \"" << mark << "\": ";
+
593  // switch(e.code()) {
+
594  // case std::regex_constants::error_collate:
+
595  // std::cerr << "the expression contains an invalid collating element name";
596  // break;
-
597  // case std::regex_constants::error_paren:
-
598  // std::cerr << "the expression contains mismatched parentheses ('(' and ')')";
+
597  // case std::regex_constants::error_ctype:
+
598  // std::cerr << "the expression contains an invalid character class name";
599  // break;
-
600  // case std::regex_constants::error_brace:
-
601  // std::cerr << "the expression contains mismatched curly braces ('{' and '}')";
+
600  // case std::regex_constants::error_escape:
+
601  // std::cerr << "the expression contains an invalid escaped character or a trailing escape";
602  // break;
-
603  // case std::regex_constants::error_badbrace:
-
604  // std::cerr << "the expression contains an invalid range in a {} expression";
+
603  // case std::regex_constants::error_backref:
+
604  // std::cerr << "the expression contains an invalid back reference";
605  // break;
-
606  // case std::regex_constants::error_range:
-
607  // std::cerr << "the expression contains an invalid character range (e.g. [b-a])";
+
606  // case std::regex_constants::error_brack:
+
607  // std::cerr << "the expression contains mismatched square brackets ('[' and ']')";
608  // break;
-
609  // case std::regex_constants::error_space:
-
610  // std::cerr << "there was not enough memory to convert the expression into a finite state machine";
+
609  // case std::regex_constants::error_paren:
+
610  // std::cerr << "the expression contains mismatched parentheses ('(' and ')')";
611  // break;
-
612  // case std::regex_constants::error_badrepeat:
-
613  // std::cerr << "one of *?+{ was not preceded by a valid regular expression";
+
612  // case std::regex_constants::error_brace:
+
613  // std::cerr << "the expression contains mismatched curly braces ('{' and '}')";
614  // break;
-
615  // case std::regex_constants::error_complexity:
-
616  // std::cerr << "the complexity of an attempted match exceeded a predefined level";
+
615  // case std::regex_constants::error_badbrace:
+
616  // std::cerr << "the expression contains an invalid range in a {} expression";
617  // break;
-
618  // case std::regex_constants::error_stack:
-
619  // std::cerr << "there was not enough memory to perform a match";
+
618  // case std::regex_constants::error_range:
+
619  // std::cerr << "the expression contains an invalid character range (e.g. [b-a])";
620  // break;
-
621  // default:
-
622  // std::cerr << "unknown error";
-
623  // }
-
624  // std::cerr << std::endl;
-
625  // throw;
-
626  // } // catch
-
627 
-
628  const std::regex re(mark);
-
629  return std::regex_replace(form, re, tag);
-
630  }
-
631 
-
633  std::string replace(
-
634  const std::string& form,
-
635  const std::string& mark,
-
636  const size_t tag
-
637  ) const
-
638  {
-
639  std::ostringstream stag; stag << tag;
-
640  return replace(form, mark, stag.str());
-
641  }
-
642 
-
644  std::string format(
-
645  std::string format,
-
646  const std::string& what,
-
647 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
648  const std::string& name,
-
649 #endif
-
650  const level& stage,
-
651  const std::string& file,
-
652  const std::string& func,
-
653  const size_t line
-
654 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
655  ,
-
656  const size_t depth
-
657 #endif
-
658  ) const
-
659  {
-
660  format = replace(format, "\\{msg\\}", what);
-
661  format = replace(format, "\\{file\\}", file);
-
662  format = replace(format, "\\{func\\}", func);
-
663  format = replace(format, "\\{line\\}", line);
-
664 
-
665  format = replace(format, "\\{level\\}", _level_word.at(stage));
-
666  std::string letter(1, _level_word.at(stage).at(0)); // char -> string
-
667  format = replace(format, "\\{level_letter\\}", letter);
-
668 
-
669 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
670  format = replace(format, "\\{name\\}", name);
-
671  format = replace(format, "\\{depth\\}", depth - _strip_calls);
-
672 
-
673  std::ostringstream chevrons;
-
674  for(size_t i = _strip_calls; i < depth; ++i) {
-
675  chevrons << _depth_mark;
-
676  }
-
677  format = replace(format, "\\{depth_marks\\}", chevrons.str());
-
678 #endif
-
679 
-
680  return _level_fmt.at(stage)(format);
-
681  }
-
682 
-
684  void log(
-
685  const level& stage,
-
686  const std::string& what,
-
687  const std::string& file, const std::string& func, size_t line
-
688  ) const
-
689  {
-
690  scope_t scope = locate(stage, file, func, line);
+
621  // case std::regex_constants::error_space:
+
622  // std::cerr << "there was not enough memory to convert the expression into a finite state machine";
+
623  // break;
+
624  // case std::regex_constants::error_badrepeat:
+
625  // std::cerr << "one of *?+{ was not preceded by a valid regular expression";
+
626  // break;
+
627  // case std::regex_constants::error_complexity:
+
628  // std::cerr << "the complexity of an attempted match exceeded a predefined level";
+
629  // break;
+
630  // case std::regex_constants::error_stack:
+
631  // std::cerr << "there was not enough memory to perform a match";
+
632  // break;
+
633  // default:
+
634  // std::cerr << "unknown error";
+
635  // }
+
636  // std::cerr << std::endl;
+
637  // throw;
+
638  // } // catch
+
639 
+
640  const std::regex re(mark);
+
641  return std::regex_replace(form, re, tag);
+
642  }
+
643 
+
645  std::string replace(
+
646  const std::string& form,
+
647  const std::string& mark,
+
648  const size_t tag
+
649  ) const
+
650  {
+
651  std::ostringstream stag; stag << tag;
+
652  return replace(form, mark, stag.str());
+
653  }
+
654 
+
656  std::string format(
+
657  std::string format,
+
658  const std::string& what,
+
659 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
660  const std::string& name,
+
661 #endif
+
662  const level& stage,
+
663  const std::string& file,
+
664  const std::string& func,
+
665  const size_t line
+
666 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
667  ,
+
668  const size_t depth
+
669 #endif
+
670  ) const
+
671  {
+
672  format = replace(format, "\\{msg\\}", what);
+
673  format = replace(format, "\\{file\\}", file);
+
674  format = replace(format, "\\{func\\}", func);
+
675  format = replace(format, "\\{line\\}", line);
+
676 
+
677  format = replace(format, "\\{level\\}", _level_word.at(stage));
+
678  std::string letter(1, _level_word.at(stage).at(0)); // char -> string
+
679  format = replace(format, "\\{level_letter\\}", letter);
+
680 
+
681 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
682  format = replace(format, "\\{name\\}", name);
+
683  format = replace(format, "\\{depth\\}", depth - _strip_calls);
+
684 
+
685  std::ostringstream chevrons;
+
686  for(size_t i = _strip_calls; i < depth; ++i) {
+
687  chevrons << _depth_mark;
+
688  }
+
689  format = replace(format, "\\{depth_marks\\}", chevrons.str());
+
690 #endif
691 
-
692  if(scope.matches) {
-
693 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
694  *_out << format(_format_log, what, basename(getenv("_")),
-
695  stage, file, func,
-
696  line, scope.depth );
-
697 #else
-
698  *_out << format(_format_log, what,
-
699  stage, file, func,
-
700  line );
-
701 
-
702 #endif
-
703  _out->flush();
-
704  } // if scopes.matches
-
705  }
-
706 
-
708  template<class In>
-
709  void dump(
-
710  const level& stage,
-
711  const In container_begin, const In container_end,
-
712  const std::string& file, const std::string& func, size_t line,
-
713  const std::string& filename_template="dump_{n}.dat",
-
714  const std::string sep=CLUTCHDUMP_DEFAULT_SEP
-
715  ) const
-
716  {
-
717  scope_t scope = locate(stage, file, func, line);
+
692  return _level_fmt.at(stage)(format);
+
693  }
+
694 
+
696  void log(
+
697  const level& stage,
+
698  const std::string& what,
+
699  const std::string& file, const std::string& func, size_t line
+
700  ) const
+
701  {
+
702  scope_t scope = locate(stage, file, func, line);
+
703 
+
704  if(scope.matches) {
+
705 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
706  *_out << format(_format_log, what, basename(getenv("_")),
+
707  stage, file, func,
+
708  line, scope.depth );
+
709 #else
+
710  *_out << format(_format_log, what,
+
711  stage, file, func,
+
712  line );
+
713 
+
714 #endif
+
715  _out->flush();
+
716  } // if scopes.matches
+
717  }
718 
-
719  if(scope.matches) {
-
720  const std::string tag = "\\{n\\}";
-
721  const std::regex re(tag);
-
722  std::string outfile = "";
-
723 
-
724  // If the file name template has the {n} tag.
-
725  if(std::regex_search(filename_template, re)) {
-
726  // Increment n until a free one is found.
-
727  size_t n = 0;
-
728  do {
-
729  outfile = replace(filename_template, tag, n);
-
730  n++;
-
731  } while( fs::exists( outfile ) );
-
732 
-
733  } else {
-
734  // Use the parameter as is.
-
735  outfile = filename_template;
-
736  }
-
737 
-
738  std::ofstream fd(outfile);
-
739 
-
740  if(_format_dump.size() > 0) {
-
741 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
742  fd << format(_format_dump, "", basename(getenv("_")),
-
743  stage, file, func,
-
744  line, scope.depth );
-
745 #else
-
746  fd << format(_format_dump, "",
-
747  stage, file, func,
-
748  line );
-
749 #endif
-
750  fd << sep; // sep after comment line.
-
751  }
-
752 
-
753  std::copy(container_begin, container_end,
-
754  std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
-
755 
-
756  fd.close();
-
757  } // if scopes.matches
-
758  }
-
759 
-
761 };
-
762 
-
765 #else // not WITH_CLUTCHLOG
-
766 
+
720  template<class In>
+
721  void dump(
+
722  const level& stage,
+
723  const In container_begin, const In container_end,
+
724  const std::string& file, const std::string& func, size_t line,
+
725  const std::string& filename_template = "dump_{n}.dat",
+
726  const std::string sep = dump_default_sep
+
727  ) const
+
728  {
+
729  scope_t scope = locate(stage, file, func, line);
+
730 
+
731  if(scope.matches) {
+
732  const std::string tag = "\\{n\\}";
+
733  const std::regex re(tag);
+
734  std::string outfile = "";
+
735 
+
736  // If the file name template has the {n} tag.
+
737  if(std::regex_search(filename_template, re)) {
+
738  // Increment n until a free one is found.
+
739  size_t n = 0;
+
740  do {
+
741  outfile = replace(filename_template, tag, n);
+
742  n++;
+
743  } while( fs::exists( outfile ) );
+
744 
+
745  } else {
+
746  // Use the parameter as is.
+
747  outfile = filename_template;
+
748  }
+
749 
+
750  std::ofstream fd(outfile);
+
751 
+
752  if(_format_dump.size() > 0) {
+
753 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
754  fd << format(_format_dump, "", basename(getenv("_")),
+
755  stage, file, func,
+
756  line, scope.depth );
+
757 #else
+
758  fd << format(_format_dump, "",
+
759  stage, file, func,
+
760  line );
+
761 #endif
+
762  fd << sep; // sep after comment line.
+
763  }
+
764 
+
765  std::copy(container_begin, container_end,
+
766  std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
767 
-
768 /**********************************************************************
-
769  * Fake implementation
-
770  **********************************************************************/
+
768  fd.close();
+
769  } // if scopes.matches
+
770  }
771 
-
772 // Equivalent class with empty methods, will be optimized out
-
773 // while allowing to actually have calls implemented without WITH_CLUTCHLOG guards.
-
774 #pragma GCC diagnostic push
-
775 #pragma GCC diagnostic ignored "-Wreturn-type"
-
776 class clutchlog
-
777 {
-
778  public:
-
779  static clutchlog& logger() { }
-
780  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
-
781  class fmt {
-
782  public:
-
783  enum class fg { black, red, green, yellow, blue, magenta, cyan, white, none } fore;
-
784  enum class bg { black, red, green, yellow, blue, magenta, cyan, white, none } back;
-
785  enum class typo { reset, bold, underline, inverse, none } style;
-
786  fmt() : fore(fg::none), back(bg::none), style(typo::none) { }
-
787  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
-
788  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) { }
-
789  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
-
790  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) { }
-
791  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) { }
-
792  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) { }
-
793  protected:
-
794  std::ostream& print_on(std::ostream&) const { }
-
795  public:
-
796  friend std::ostream& operator<<(std::ostream&, const fmt&) { }
-
797  std::string operator()(const std::string&) const { }
-
798  };
-
799  public:
-
800  clutchlog(clutchlog const&) = delete;
-
801  void operator=(clutchlog const&) = delete;
-
802  private:
-
803  clutchlog() {}
-
804  protected:
-
805  struct scope_t {};
-
806  scope_t locate(
-
807  const level&,
-
808  const std::string&,
-
809  const std::string&,
-
810  const size_t
-
811  ) const
-
812  { }
-
813  public:
-
814  void format(const std::string&) {}
-
815  std::string format() const {}
-
816 
-
817  void format_comment(const std::string&) {}
-
818  std::string format_comment() const {}
-
819 
-
820  void out(std::ostream&) {}
-
821  std::ostream& out() {}
-
822 
-
823 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
824  void depth(size_t) {}
-
825  size_t depth() const {}
-
826 
-
827  void depth_mark(std::string) {}
-
828  std::string depth_mark() const {}
-
829 #endif
-
830 
-
831  void threshold(level) {}
-
832  level threshold() const {}
-
833 
-
834  void file(std::string) {}
-
835  void func(std::string) {}
-
836  void line(std::string) {}
-
837 
-
838 #pragma GCC diagnostic push
-
839 #pragma GCC diagnostic ignored "-Wunused-parameter"
-
840  void location(
-
841  const std::string&,
-
842  const std::string& in_function=".*",
-
843  const std::string& in_line=".*"
-
844  )
-
845  { }
-
846 #pragma GCC diagnostic pop
-
847  void style(level, fmt) { }
-
848  fmt style(level) const { }
-
849  level level_of(const std::string) { }
-
850  public:
-
851  std::string replace(
-
852  const std::string&,
+
773 };
+
774 
+
777 #else // not WITH_CLUTCHLOG
+
778 
+
779 
+
780 /**********************************************************************
+
781  * Fake implementation
+
782  **********************************************************************/
+
783 
+
784 // Equivalent class with empty methods, will be optimized out
+
785 // while allowing to actually have calls implemented without WITH_CLUTCHLOG guards.
+
786 #pragma GCC diagnostic push
+
787 #pragma GCC diagnostic ignored "-Wreturn-type"
+
788 class clutchlog
+
789 {
+
790  public:
+
791  static clutchlog& logger() { }
+
792  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
+
793  class fmt {
+
794  public:
+
795  enum class fg { black, red, green, yellow, blue, magenta, cyan, white, none } fore;
+
796  enum class bg { black, red, green, yellow, blue, magenta, cyan, white, none } back;
+
797  enum class typo { reset, bold, underline, inverse, none } style;
+
798  fmt() : fore(fg::none), back(bg::none), style(typo::none) { }
+
799  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
+
800  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) { }
+
801  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) { }
+
802  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) { }
+
803  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) { }
+
804  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) { }
+
805  protected:
+
806  std::ostream& print_on(std::ostream&) const { }
+
807  public:
+
808  friend std::ostream& operator<<(std::ostream&, const fmt&) { }
+
809  std::string operator()(const std::string&) const { }
+
810  };
+
811  public:
+
812  clutchlog(clutchlog const&) = delete;
+
813  void operator=(clutchlog const&) = delete;
+
814  private:
+
815  clutchlog() {}
+
816  protected:
+
817  struct scope_t {};
+
818  scope_t locate(
+
819  const level&,
+
820  const std::string&,
+
821  const std::string&,
+
822  const size_t
+
823  ) const
+
824  { }
+
825  public:
+
826  void format(const std::string&) {}
+
827  std::string format() const {}
+
828 
+
829  void format_comment(const std::string&) {}
+
830  std::string format_comment() const {}
+
831 
+
832  void out(std::ostream&) {}
+
833  std::ostream& out() {}
+
834 
+
835 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
836  void depth(size_t) {}
+
837  size_t depth() const {}
+
838 
+
839  void depth_mark(std::string) {}
+
840  std::string depth_mark() const {}
+
841 #endif
+
842 
+
843  void threshold(level) {}
+
844  level threshold() const {}
+
845 
+
846  void file(std::string) {}
+
847  void func(std::string) {}
+
848  void line(std::string) {}
+
849 
+
850 #pragma GCC diagnostic push
+
851 #pragma GCC diagnostic ignored "-Wunused-parameter"
+
852  void location(
853  const std::string&,
-
854  const std::string&
-
855  ) const
-
856  { }
-
857 
-
858  std::string replace(
-
859  const std::string&,
-
860  const std::string&,
-
861  const size_t
-
862  ) const
-
863  { }
-
864 
-
865  std::string format(
-
866  std::string,
-
867  const std::string&,
-
868 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
869  const std::string&,
-
870 #endif
-
871  const level&,
+
854  const std::string& in_function=".*",
+
855  const std::string& in_line=".*"
+
856  )
+
857  { }
+
858 #pragma GCC diagnostic pop
+
859  void style(level, fmt) { }
+
860  fmt style(level) const { }
+
861  level level_of(const std::string) { }
+
862  public:
+
863  std::string replace(
+
864  const std::string&,
+
865  const std::string&,
+
866  const std::string&
+
867  ) const
+
868  { }
+
869 
+
870  std::string replace(
+
871  const std::string&,
872  const std::string&,
-
873  const std::string&,
-
874  const size_t
-
875 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
876  ,
-
877  const size_t
-
878 #endif
-
879  ) const
-
880  { }
-
881 
-
882  void log(
-
883  const level&,
+
873  const size_t
+
874  ) const
+
875  { }
+
876 
+
877  std::string format(
+
878  std::string,
+
879  const std::string&,
+
880 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
881  const std::string&,
+
882 #endif
+
883  const level&,
884  const std::string&,
-
885  const std::string&, const std::string&, size_t
-
886  ) const
-
887  { }
-
888 
-
889  template<class In>
-
890  void dump(
-
891  const level&,
-
892  const In, const In,
-
893  const std::string&, const std::string&, size_t,
-
894  const std::string&,
-
895  const std::string
-
896  ) const
-
897  { }
-
898 };
-
899 #pragma GCC diagnostic pop
-
900 #endif // WITH_CLUTCHLOG
-
901 
-
902 #endif // __CLUTCHLOG_H__
+
885  const std::string&,
+
886  const size_t
+
887 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
888  ,
+
889  const size_t
+
890 #endif
+
891  ) const
+
892  { }
+
893 
+
894  void log(
+
895  const level&,
+
896  const std::string&,
+
897  const std::string&, const std::string&, size_t
+
898  ) const
+
899  { }
+
900 
+
901  template<class In>
+
902  void dump(
+
903  const level&,
+
904  const In, const In,
+
905  const std::string&, const std::string&, size_t,
+
906  const std::string&,
+
907  const std::string
+
908  ) const
+
909  { }
+
910 };
+
911 #pragma GCC diagnostic pop
+
912 #endif // WITH_CLUTCHLOG
+
913 
+
914 #endif // __CLUTCHLOG_H__
-
clutchlog::log
void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
Print a log message IF the location matches the given one.
Definition: clutchlog.h:684
-
CLUTCHDUMP_DEFAULT_SEP
#define CLUTCHDUMP_DEFAULT_SEP
Default item separator for dump.
Definition: clutchlog.h:73
-
clutchlog::line
void line(std::string line)
Set the regular expression filtering the line location.
Definition: clutchlog.h:451
-
clutchlog::out
void out(std::ostream &out)
Set the output stream on which to print.
Definition: clutchlog.h:425
-
clutchlog::replace
std::string replace(const std::string &form, const std::string &mark, const std::string &tag) const
Replace mark by tag in form.
Definition: clutchlog.h:568
-
CLUTCHLOG_DEFAULT_FORMAT
#define CLUTCHLOG_DEFAULT_FORMAT
Default format of the messages.
Definition: clutchlog.h:58
-
clutchlog::fmt::fg
fg
Foreground color codes.
Definition: clutchlog.h:232
-
CLUTCHLOG_STRIP_CALLS
#define CLUTCHLOG_STRIP_CALLS
Number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:88
-
clutchlog::format_comment
void format_comment(const std::string &format)
Set the template string for dumps.
Definition: clutchlog.h:420
-
clutchlog::file
void file(std::string file)
Set the regular expression filtering the file location.
Definition: clutchlog.h:447
-
clutchlog::locate
scope_t locate(const level &stage, const std::string &file, const std::string &func, const size_t line) const
Gather information on the current location of the call.
Definition: clutchlog.h:517
-
clutchlog::fmt::fmt
fmt()
&#160;Empty constructor, only useful for a no-op formatter.
Definition: clutchlog.h:267
-
clutchlog::style
void style(level stage, fmt style)
Set the style (color and typo) of the given log level, passing a fmt instance.
Definition: clutchlog.h:472
-
clutchlog::threshold
void threshold(level l)
Set the log level below which logs are not printed.
Definition: clutchlog.h:442
-
clutchlog::threshold
level threshold() const
Get the log level below which logs are not printed.
Definition: clutchlog.h:444
-
clutchlog::level
level
Available log levels.
Definition: clutchlog.h:215
-
clutchlog::fmt::bg
bg
Background color codes.
Definition: clutchlog.h:245
-
clutchlog::format
std::string format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const
Substitute all tags in the format string with the corresponding information and apply the style corre...
Definition: clutchlog.h:644
-
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:208
-
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:229
-
clutchlog::func
void func(std::string func)
Set the regular expression filtering the function location.
Definition: clutchlog.h:449
-
clutchlog::format
std::string format() const
Get the template string.
Definition: clutchlog.h:417
-
CLUTCHDUMP_DEFAULT_FORMAT
#define CLUTCHDUMP_DEFAULT_FORMAT
Default format of the comment line in file dump.
Definition: clutchlog.h:67
-
clutchlog::style
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
Definition: clutchlog.h:470
-
clutchlog::level_of
level level_of(const std::string name)
Return the log level tag corresponding to the given pre-configured name.
Definition: clutchlog.h:480
-
clutchlog::fmt::operator()
std::string operator()(const std::string &msg) const
Format the given string with the currently encoded format.
Definition: clutchlog.h:326
-
clutchlog::replace
std::string replace(const std::string &form, const std::string &mark, const size_t tag) const
Replace mark by tag in form, converting tag to its string representation first.
Definition: clutchlog.h:633
-
clutchlog::format_comment
std::string format_comment() const
Get the template string for dumps.
Definition: clutchlog.h:422
-
clutchlog::dump
void dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=CLUTCHDUMP_DEFAULT_SEP) const
Dump a serializable container after a comment line with log information.
Definition: clutchlog.h:709
-
clutchlog::scope_t
Structure holding a location matching.
Definition: clutchlog.h:498
-
clutchlog::fmt::print_on
std::ostream & print_on(std::ostream &os) const
Print the currently encoded format escape code on the given output stream.
Definition: clutchlog.h:281
-
clutchlog::out
std::ostream & out()
Get the output stream on which to print.
Definition: clutchlog.h:427
-
CLUTCHLOG_DEFAULT_DEPTH_MARK
#define CLUTCHLOG_DEFAULT_DEPTH_MARK
Default mark for stack depth.
Definition: clutchlog.h:78
-
clutchlog::fmt::operator<<
friend std::ostream & operator<<(std::ostream &os, const fmt &fmt)
Output stream overload.
Definition: clutchlog.h:311
-
clutchlog::style
fmt style(level stage) const
Get the configured fmt instance of the given log level.
Definition: clutchlog.h:474
-
clutchlog::fmt::typo
typo
Typographic style codes.
Definition: clutchlog.h:258
-
clutchlog::location
void location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")
Set the regular expressions filtering the location.
Definition: clutchlog.h:454
-
clutchlog
Definition: clutchlog.h:196
+
clutchlog::file
void file(std::string file)
Set the regular expression filtering the file location.
Definition: clutchlog.h:459
+
CLUTCHDUMP_DEFAULT_FORMAT
#define CLUTCHDUMP_DEFAULT_FORMAT
Default format of the comment line in file dump.
Definition: clutchlog.h:185
+
clutchlog::fmt::fg
fg
Foreground color codes.
Definition: clutchlog.h:244
+
clutchlog::out
void out(std::ostream &out)
Set the output stream on which to print.
Definition: clutchlog.h:437
+
clutchlog::fmt::fmt
fmt()
&#160;Empty constructor, only useful for a no-op formatter.
Definition: clutchlog.h:279
+
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:220
+
clutchlog::line
void line(std::string line)
Set the regular expression filtering the line location.
Definition: clutchlog.h:463
+
clutchlog::format_comment
void format_comment(const std::string &format)
Set the template string for dumps.
Definition: clutchlog.h:432
+
clutchlog::fmt::typo
typo
Typographic style codes.
Definition: clutchlog.h:270
+
CLUTCHDUMP_DEFAULT_SEP
#define CLUTCHDUMP_DEFAULT_SEP
Default item separator for dump.
Definition: clutchlog.h:192
+
CLUTCHLOG_DEFAULT_FORMAT
#define CLUTCHLOG_DEFAULT_FORMAT
Default format of the messages.
Definition: clutchlog.h:175
+
clutchlog::format
std::string format() const
Get the template string.
Definition: clutchlog.h:429
+
clutchlog::log
void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
Print a log message IF the location matches the given one.
Definition: clutchlog.h:696
+
clutchlog::level_of
level level_of(const std::string name)
Return the log level tag corresponding to the given pre-configured name.
Definition: clutchlog.h:492
+
clutchlog::fmt::operator()
std::string operator()(const std::string &msg) const
Format the given string with the currently encoded format.
Definition: clutchlog.h:338
+
clutchlog::format
std::string format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const
Substitute all tags in the format string with the corresponding information and apply the style corre...
Definition: clutchlog.h:656
+
clutchlog::level
level
Available log levels.
Definition: clutchlog.h:227
+
CLUTCHLOG_DEFAULT_DEPTH_MARK
#define CLUTCHLOG_DEFAULT_DEPTH_MARK
Default mark for stack depth.
Definition: clutchlog.h:198
+
clutchlog::fmt::operator<<
friend std::ostream & operator<<(std::ostream &os, const fmt &fmt)
Output stream overload.
Definition: clutchlog.h:323
+
clutchlog::format_comment
std::string format_comment() const
Get the template string for dumps.
Definition: clutchlog.h:434
+
CLUTCHLOG_STRIP_CALLS
#define CLUTCHLOG_STRIP_CALLS
Number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:204
+
clutchlog::func
void func(std::string func)
Set the regular expression filtering the function location.
Definition: clutchlog.h:461
+
clutchlog::location
void location(const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")
Set the regular expressions filtering the location.
Definition: clutchlog.h:466
+
clutchlog::dump
void dump(const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) const
Dump a serializable container after a comment line with log information.
Definition: clutchlog.h:721
+
clutchlog::replace
std::string replace(const std::string &form, const std::string &mark, const size_t tag) const
Replace mark by tag in form, converting tag to its string representation first.
Definition: clutchlog.h:645
+
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:241
+
clutchlog::out
std::ostream & out()
Get the output stream on which to print.
Definition: clutchlog.h:439
+
clutchlog::replace
std::string replace(const std::string &form, const std::string &mark, const std::string &tag) const
Replace mark by tag in form.
Definition: clutchlog.h:580
+
clutchlog::scope_t
Structure holding a location matching.
Definition: clutchlog.h:510
+
clutchlog::threshold
void threshold(level l)
Set the log level below which logs are not printed.
Definition: clutchlog.h:454
+
clutchlog::style
void style(level stage, fmt style)
Set the style (color and typo) of the given log level, passing a fmt instance.
Definition: clutchlog.h:484
+
clutchlog::locate
scope_t locate(const level &stage, const std::string &file, const std::string &func, const size_t line) const
Gather information on the current location of the call.
Definition: clutchlog.h:529
+
clutchlog::threshold
level threshold() const
Get the log level below which logs are not printed.
Definition: clutchlog.h:456
+
clutchlog::fmt::print_on
std::ostream & print_on(std::ostream &os) const
Print the currently encoded format escape code on the given output stream.
Definition: clutchlog.h:293
+
clutchlog::style
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
Definition: clutchlog.h:482
+
clutchlog
Definition: clutchlog.h:164
+
clutchlog::style
fmt style(level stage) const
Get the configured fmt instance of the given log level.
Definition: clutchlog.h:486
+
clutchlog::fmt::bg
bg
Background color codes.
Definition: clutchlog.h:257
Generated by   diff --git a/docs/dir_000050_000000.html b/docs/dir_000050_000000.html index db45639..e7204aa 100644 --- a/docs/dir_000050_000000.html +++ b/docs/dir_000050_000000.html @@ -66,7 +66,7 @@ $(function() {
-

tests → clutchlog Relation

File in testsIncludes file in clutchlog
t-assert.cppclutchlog.h
t-color.cppclutchlog.h
t-demo.cppclutchlog.h
t-dump.cppclutchlog.h
t-log.cppclutchlog.h
+

tests → clutchlog Relation

File in testsIncludes file in clutchlog
t-assert.cppclutchlog.h
t-color.cppclutchlog.h
t-demo.cppclutchlog.h
t-dump.cppclutchlog.h
t-log.cppclutchlog.h
t-one-line-if.cppclutchlog.h
Generated by   diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html index 35e431c..10f566b 100644 --- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html +++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html @@ -77,7 +77,7 @@ Directory dependency graph for tests: - + diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map index ea00df7..fc88641 100644 --- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map +++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map @@ -1,5 +1,5 @@ - + diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 index 47ba441..c963725 100644 --- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 +++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 @@ -1 +1 @@ -d4d81e1e042ac800c009c85756147e76 \ No newline at end of file +34c2c7768310b6f121c9272e1093428c \ No newline at end of file diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.png b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.png index 4ca4da7..7fee3d4 100644 Binary files a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.png and b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.png differ diff --git a/docs/functions.html b/docs/functions.html index df8b594..12380e1 100644 --- a/docs/functions.html +++ b/docs/functions.html @@ -66,105 +66,105 @@ $(function() {

- b -

- d -

- f -

- l -

- o -

- p -

- r -

- s -

- t -

diff --git a/docs/functions_enum.html b/docs/functions_enum.html index 846cb0c..2e1f56f 100644 --- a/docs/functions_enum.html +++ b/docs/functions_enum.html @@ -64,16 +64,16 @@ $(function() {
 
diff --git a/docs/functions_func.html b/docs/functions_func.html index 4dee3a4..ebdc7bd 100644 --- a/docs/functions_func.html +++ b/docs/functions_func.html @@ -64,58 +64,58 @@ $(function() {
 
diff --git a/docs/functions_rela.html b/docs/functions_rela.html index 95f2c7f..8a67e5d 100644 --- a/docs/functions_rela.html +++ b/docs/functions_rela.html @@ -64,7 +64,7 @@ $(function() {
 
diff --git a/docs/globals.html b/docs/globals.html index 9ee8a60..71b1589 100644 --- a/docs/globals.html +++ b/docs/globals.html @@ -70,10 +70,10 @@ $(function() { : clutchlog.h
  • CLUTCHDUMP_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHDUMP_DEFAULT_SEP -: clutchlog.h +: clutchlog.h
  • CLUTCHFUNC : clutchlog.h @@ -88,13 +88,13 @@ $(function() { : clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_MARK -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_STRIP_CALLS -: clutchlog.h +: clutchlog.h
  • WITH_CLUTCHLOG : clutchlog.h diff --git a/docs/globals_defs.html b/docs/globals_defs.html index 54c4062..521c1fd 100644 --- a/docs/globals_defs.html +++ b/docs/globals_defs.html @@ -70,10 +70,10 @@ $(function() { : clutchlog.h
  • CLUTCHDUMP_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHDUMP_DEFAULT_SEP -: clutchlog.h +: clutchlog.h
  • CLUTCHFUNC : clutchlog.h @@ -88,13 +88,13 @@ $(function() { : clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_MARK -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_STRIP_CALLS -: clutchlog.h +: clutchlog.h
  • WITH_CLUTCHLOG : clutchlog.h diff --git a/docs/group__DefaultConfigMacros.html b/docs/group__DefaultConfigMacros.html index 61376a4..3d0959d 100644 --- a/docs/group__DefaultConfigMacros.html +++ b/docs/group__DefaultConfigMacros.html @@ -71,30 +71,10 @@ $(function() { - - - - - - - - - - - - - - -

    Macros

    -#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
     Default format of the messages.
     
    -#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}"
     Default format of the comment line in file dump.
     
    -#define CLUTCHDUMP_DEFAULT_SEP   "\n"
     Default item separator for dump.
     
    -#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">"
     Default mark for stack depth.
     
    #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG   clutchlog::level::progress
     Default level over which calls to the logger are optimized out when NDEBUG is defined.
     
    -#define CLUTCHLOG_STRIP_CALLS   5
     Number of call stack levels to remove from depth display by default.
     

    Detailed Description

    diff --git a/docs/group__Formating.html b/docs/group__Formating.html index ca16420..f89eca3 100644 --- a/docs/group__Formating.html +++ b/docs/group__Formating.html @@ -65,9 +65,18 @@ $(function() {
    Classes
    -
    Formating tools
    +
    Formating tools
    High-level API macros
    +
    +Collaboration diagram for Formating tools:
    +
    +
    + + + + +
    diff --git a/docs/group__UseMacros.html b/docs/group__UseMacros.html index 8ddd777..eda892e 100644 --- a/docs/group__UseMacros.html +++ b/docs/group__UseMacros.html @@ -63,12 +63,39 @@ $(function() {
    -Macros
    +Modules | +Classes | +Macros | +Enumerations | +Enumerator | +Functions | +Variables | +Friends
    High-level API macros
    +
    +Collaboration diagram for High-level API macros:
    +
    +
    + + + + +

    Classes

    + + + +

    +Modules

     Formating tools
     
    + + + + +

    +Classes

    struct  clutchlog::scope_t
     Structure holding a location matching. More...
     
    + + + + + + + + + + + + + + + +

    Macros

    @@ -87,6 +114,307 @@ Macros
    #define CLUTCHCODE(LEVEL, ...)
     Run any code if the scope matches. More...
     
    +#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
     Default format of the messages.
     
    +#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}"
     Default format of the comment line in file dump.
     
    +#define CLUTCHDUMP_DEFAULT_SEP   "\n"
     Default item separator for dump.
     
    +#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">"
     Default mark for stack depth.
     
    +#define CLUTCHLOG_STRIP_CALLS   5
     Number of call stack levels to remove from depth display by default.
     
    + + + + + + + + + + +

    +Enumerations

    enum  clutchlog::fmt::fg {
    +  black = 30, +red = 31, +green = 32, +yellow = 33, +
    +  blue = 34, +magenta = 35, +cyan = 36, +white = 37, +
    +  none +
    + }
     Foreground color codes.
     
    enum  clutchlog::fmt::bg {
    +  black = 40, +red = 41, +green = 42, +yellow = 43, +
    +  blue = 44, +magenta = 45, +cyan = 46, +white = 47, +
    +  none +
    + }
     Background color codes.
     
    enum  clutchlog::fmt::typo {
    +  reset = 0, +bold = 1, +underline = 4, +inverse = 7, +
    +  none +
    + }
     Typographic style codes.
     
    + + + + + + + + + + +

    +Functions

    + clutchlog::fmt::fmt ()
      Empty constructor, only useful for a no-op formatter.
     
    +std::ostream & clutchlog::fmt::print_on (std::ostream &os) const
     Print the currently encoded format escape code on the given output stream.
     
    std::string clutchlog::fmt::operator() (const std::string &msg) const
     Format the given string with the currently encoded format. More...
     
    + + + + + + + + + + + + + + + + + + + + + + + +

    +Variables

    +static std::string clutchlog::default_format = CLUTCHLOG_DEFAULT_FORMAT
     
    +static std::string clutchlog::dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
     
    +static std::string clutchlog::dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
     
    +static std::string clutchlog::default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
     
    +static unsigned int clutchlog::strip_calls = CLUTCHLOG_STRIP_CALLS
     
    +enum clutchlog::fmt::fg clutchlog::fmt::fore
     
    +enum clutchlog::fmt::bg clutchlog::fmt::back
     
    +enum clutchlog::fmt::typo clutchlog::fmt::style
     
    +bool clutchlog::scope_t::matches
     
    +level clutchlog::scope_t::stage
     
    +bool clutchlog::scope_t::there
     
    + + + + +

    +Friends

    std::ostream & clutchlog::fmt::operator<< (std::ostream &os, const fmt &fmt)
     Output stream overload. More...
     
    + + + + + + + +

    +High-level API

    enum  clutchlog::level {
    +  critical =0, +error =1, +warning =2, +progress =3, +
    +  note =4, +info =5, +debug =6, +xdebug =7 +
    + }
     Available log levels.
     
    static clutchlog & clutchlog::logger ()
     Get the logger instance. More...
     
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    +Internal details

    +const size_t clutchlog::_strip_calls
     
    +const std::map< level, std::string > clutchlog::_level_word
     
    +std::map< std::string, level > clutchlog::_word_level
     
    +std::map< level, fmt > clutchlog::_level_fmt
     
    +std::string clutchlog::_format_log
     
    +std::string clutchlog::_format_dump
     
    +std::ostream * clutchlog::_out
     
    +level clutchlog::_stage
     
    +std::regex clutchlog::_in_file
     
    +std::regex clutchlog::_in_func
     
    +std::regex clutchlog::_in_line
     
    +static const size_t clutchlog::max_buffer = 4096
     
    + clutchlog::clutchlog (clutchlog const &)=delete
     
    +void clutchlog::operator= (clutchlog const &)=delete
     
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    +Configuration accessors

    +void clutchlog::format (const std::string &format)
     Set the template string.
     
    +std::string clutchlog::format () const
     Get the template string.
     
    +void clutchlog::format_comment (const std::string &format)
     Set the template string for dumps.
     
    +std::string clutchlog::format_comment () const
     Get the template string for dumps.
     
    +void clutchlog::out (std::ostream &out)
     Set the output stream on which to print.
     
    +std::ostream & clutchlog::out ()
     Get the output stream on which to print.
     
    +void clutchlog::threshold (level l)
     Set the log level below which logs are not printed.
     
    +level clutchlog::threshold () const
     Get the log level below which logs are not printed.
     
    +void clutchlog::file (std::string file)
     Set the regular expression filtering the file location.
     
    +void clutchlog::func (std::string func)
     Set the regular expression filtering the function location.
     
    +void clutchlog::line (std::string line)
     Set the regular expression filtering the line location.
     
    +void clutchlog::location (const std::string &in_file, const std::string &in_function=".*", const std::string &in_line=".*")
     Set the regular expressions filtering the location.
     
    template<class ... FMT>
    void clutchlog::style (level stage, FMT... styles)
     Set the style (color and typo) of the given log level. More...
     
    +void clutchlog::style (level stage, fmt style)
     Set the style (color and typo) of the given log level, passing a fmt instance.
     
    +fmt clutchlog::style (level stage) const
     Get the configured fmt instance of the given log level.
     
    level clutchlog::level_of (const std::string name)
     Return the log level tag corresponding to the given pre-configured name. More...
     
    + + + + + + + + + + + + + + + + + + + + +

    +Low-level API

    +scope_t clutchlog::locate (const level &stage, const std::string &file, const std::string &func, const size_t line) const
     Gather information on the current location of the call.
     
    std::string clutchlog::replace (const std::string &form, const std::string &mark, const std::string &tag) const
     Replace mark by tag in form. More...
     
    +std::string clutchlog::replace (const std::string &form, const std::string &mark, const size_t tag) const
     Replace mark by tag in form, converting tag to its string representation first.
     
    +std::string clutchlog::format (std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const
     Substitute all tags in the format string with the corresponding information and apply the style corresponding to the log level.
     
    +void clutchlog::log (const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
     Print a log message IF the location matches the given one.
     
    +template<class In >
    void clutchlog::dump (const level &stage, const In container_begin, const In container_end, const std::string &file, const std::string &func, size_t line, const std::string &filename_template="dump_{n}.dat", const std::string sep=dump_default_sep) const
     Dump a serializable container after a comment line with log information.
     
    + + + + + + + + + + + + +

    +All combination of constructors with different parameters orders.

    + clutchlog::fmt::fmt (fg f, bg b=bg::none, typo s=typo::none)
     
    + clutchlog::fmt::fmt (fg f, typo s, bg b=bg::none)
     
    + clutchlog::fmt::fmt (bg b, fg f=fg::none, typo s=typo::none)
     
    + clutchlog::fmt::fmt (bg b, typo s, fg f=fg::none)
     
    + clutchlog::fmt::fmt (typo s, fg f=fg::none, bg b=bg::none)
     
    + clutchlog::fmt::fmt (typo s, bg b, fg f=fg::none)
     

    Detailed Description

    Macro Definition Documentation

    @@ -115,13 +443,13 @@ Macros
    -Value:
    { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    -
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    -
    if(clutchlog__scope.matches) { \
    -
    __VA_ARGS__ \
    -
    } \
    -
    }
    +Value:
    do { \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    +
    if(clutchlog__scope.matches) { \
    +
    __VA_ARGS__ \
    +
    } \
    +
    } while(0)

    Run any code if the scope matches.

    @@ -158,11 +486,11 @@ Macros
    -Value:
    { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    -
    clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
    -
    CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
    -
    }
    +Value:
    do { \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
    +
    CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
    +
    } while(0)

    Dump the given container.

    @@ -199,13 +527,13 @@ Macros
    -Value:
    { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    -
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    -
    if(clutchlog__scope.matches) { \
    -
    FUNC(__VA_ARGS__); \
    -
    } \
    -
    }
    +Value:
    do { \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    +
    if(clutchlog__scope.matches) { \
    +
    FUNC(__VA_ARGS__); \
    +
    } \
    +
    } while(0)

    Call any function if the scope matches.

    @@ -236,20 +564,241 @@ Macros
    -Value:
    { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    -
    std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
    -
    clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
    -
    }
    +Value:
    do { \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
    +
    clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
    +
    } while(0)

    Log a message at the given level.

    +
    +
    +

    Function Documentation

    + +

    ◆ level_of()

    + +
    +
    + + + + + +
    + + + + + + + + +
    level clutchlog::level_of (const std::string name)
    +     		+inline
    +
    + +

    Return the log level tag corresponding to the given pre-configured name.

    +
    Note
    This is case sensitive, see the pre-configured _level_word.
    + +
    +
    + +

    ◆ logger()

    + +
    +
    + + + + + +
    + + + + + + + +
    static clutchlog& clutchlog::logger ()
    +     		+inlinestatic
    +
    + +

    Get the logger instance.

    +
    auto& log = clutchlog::logger();
    +
    +
    +
    + +

    ◆ operator()()

    + +
    +
    + + + + + +
    + + + + + + + + +
    std::string clutchlog::fmt::operator() (const std::string & msg) const
    +     		+inline
    +
    + +

    Format the given string with the currently encoded format.

    +

    Allow to use a formatter as a function:

    clutchlog::fmt error(clutchlog::fmt::fg::red, clutchlog::fmt::typo::bold);
    +
    std::cout << error("ERROR") << std::endl;
    +
    Note
    A formatter called this way WILL output a reset escape code at the end.
    + +
    +
    + +

    ◆ replace()

    + +
    +
    + + + + + +
    + + + + + + + + + + + + + + + + + + + + + + + + +
    std::string clutchlog::replace (const std::string & form,
    const std::string & mark,
    const std::string & tag 
    ) const
    +     		+inline
    +
    + +

    Replace mark by tag in form.

    +
    log.replace("{greet} {world}", "\\{greet\\}", "hello");
    +
    // returns "hello {world}"
    +
    +
    +
    + +

    ◆ style()

    + +
    +
    +
    +template<class ... FMT>
    + + + + + +
    + + + + + + + + + + + + + + + + + + +
    void clutchlog::style (level stage,
    FMT... styles 
    )
    +     		+inline
    +
    + +

    Set the style (color and typo) of the given log level.

    +

    This version accept style arguments as if they were passed to clutchlog::fmt.

    + +
    +
    +

    Friends

    + +

    ◆ operator<<

    + +
    +
    + + + + + +
    + + + + + + + + + + + + + + + + + + +
    std::ostream& operator<< (std::ostream & os,
    const fmt & fmt 
    )
    +     		+friend
    +
    + +

    Output stream overload.

    +

    Allow to use a formatter as a tag within a stream:

    clutchlog::fmt end(clutchlog::fmt::typo::reset);
    +
    clutchlog::fmt error(clutchlog::fmt::fg::red, clutchlog::fmt::typo::bold);
    +
    std::cout << error << "ERROR" << end << std::endl;
    +
    Note
    An formatter called this way will NOT output a reset escape code.
    +
    -
    CLUTCHDUMP_DEFAULT_SEP
    #define CLUTCHDUMP_DEFAULT_SEP
    Default item separator for dump.
    Definition: clutchlog.h:73
    -
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:96
    -
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:208
    +
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:220
    +
    CLUTCHDUMP_DEFAULT_SEP
    #define CLUTCHDUMP_DEFAULT_SEP
    Default item separator for dump.
    Definition: clutchlog.h:192
    +
    clutchlog::log
    void log(const level &stage, const std::string &what, const std::string &file, const std::string &func, size_t line) const
    Print a log message IF the location matches the given one.
    Definition: clutchlog.h:696
    +
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:65
    +
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:241
    Generated by   diff --git a/docs/index.html b/docs/index.html index 03f5da3..34f85ac 100644 --- a/docs/index.html +++ b/docs/index.html @@ -5,7 +5,7 @@ -clutchlog: Main Page +clutchlog: Clutchlog — versatile (de)clutchable logging @@ -63,7 +63,7 @@ $(function() {
    -
    clutchlog Documentation
    +
    Clutchlog — versatile (de)clutchable logging

    Table of Contents

    @@ -85,13 +85,13 @@ $(function() {
  • Build and tests
    • -

    Clutchlog is a logging system which targets versatile debugging. It allows to (de)clutch messages for a given: log level, source code location or call stack depth.

    +

    Clutchlog is a logging system that targets versatile debugging. It allows to (de)clutch messages for a given: log level, source code location or call stack depth.

    Features

    Clutchlog allows to select which log messages will be displayed, based on their locations:

    • Classical log levels: each message has a given detail level and it is displayed if you ask for a at least the same one.
      • -
    • Call stack depth: you can ask to display messages within functions which are called up to a given stack depth.
      • +
    • Call stack depth: you can ask to display messages within functions that are called up to a given stack depth.
    • Source code location: you can ask to display messages called from given files, functions and line number, all based on regular expressions.

    Additionally, Clutchlog will do its best to allow the compiler to optimize out calls, for instance debug messages in "Release" builds.

    @@ -105,7 +105,7 @@ Features

    Example

    Adding a message is a simple as calling a macro (which is declutched in Debug build type, when NDEBUG is not defined):

    CLUTCHLOG(info, "matrix size: " << m << "x" << n);
    -

    To configure the display, you indicate the three types of locations, for example in your main function:

    auto& log = clutchlog::logger();
    +

    To configure the display, you indicate the three types of locations, for example in your main function:

    auto& log = clutchlog::logger();
    log.depth(2); // Log functions called from "main" but not below.
    log.threshold(clutchlog::level::info); // Log only "info", "warning", "error" or "critical" messages.
    log.file("algebra/.*"); // Will match any file in the "algebra" directory.
    @@ -115,13 +115,13 @@ Example Rationale

    Most of existing logging systems targets service events storage, like fast queuing of transactions in a round-robin database. Their aim is to provide a simple interface to efficiently store messages somewhere, which is appropriated when you have a well known service running and you want to be able to trace complex users interactions across its states.

    Clutchlog, however, targets the debugging of a (typically single-run) program. While you develop your software, it's common practice to output several detailled informations on the internal states around the feature you are currently programming. However, once the feature is up and running, those detailled informations are only useful if you encounter a bug traversing this specific part.

    -

    While tracing a bug, it is tedious to uncomment old debugging code (and go on the build-test cycle) or to set up a full debugger session which displays all appropriate data (with ad-hoc fancy hooks).

    +

    While tracing a bug, it is tedious to uncomment old debugging code (and go on the build-test cycle) or to set up a full debugger session that displays all appropriate data (with ad-hoc fancy hooks).

    To solve this problem, Clutchlog allows to disengage your debug log messages in various parts of the program, allowing for the fast tracking of a bug across the execution.

    API documentation

    Calls

    -

    The main entrypoint is the CLUTCHLOG macro, which takes the desired log level and message. The message can be anything which can be output in an ostringstream.

    // Simple string:
    +

    The main entrypoint is the CLUTCHLOG macro, which takes the desired log level and message. The message can be anything that can be output in an ostringstream.

    // Simple string:
    CLUTCHLOG(info, "hello world");
    // Serialisable variable:
    @@ -142,10 +142,10 @@ Calls

    Note that if you pass a file name without the {n} tag, the file will be overwritten as is.

    Location filtering

    -

    To configure the global behaviour of the logger, you must first get a reference on its (singleton) instance:

    auto& log = clutchlog::logger();
    +

    To configure the global behaviour of the logger, you must first get a reference on its (singleton) instance:

    auto& log = clutchlog::logger();

    One can configure the location(s) at which messages should actually be logged:

    log.depth(3); // Depth of the call stack, defaults to the maximum possible value.
    log.threshold(clutchlog::level::error); // Log level, defaults to error.
    -

    Current levels are defined in an enumeration as clutchlog::level:

    enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
    +

    Current levels are defined in an enumeration as clutchlog::level:

    enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};

    File, function and line filters are indicated using (ECMAScript) regular expressions:

    log.file(".*"); // File location, defaults to any.
    log.func(".*"); // Function location, defaults to any.
    log.line(".*"); // Line location, defaults to any.
    @@ -170,7 +170,7 @@ Output Configuration

    The default log format is "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n", it can be overriden at compile time by defining the CLUTCHLOG_DEFAULT_FORMAT macro.

    The default format of the first line of comment added with the dump macro is "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}". It can be edited with the format_comment method. If it is set to an empty string, then no comment line is added. The default can be modified at compile time with CLUTCHDUMP_DEFAULT_FORMAT. By default, the separator between items in the container is a new line. To change this behaviour, you can change CLUTCHDUMP_DEFAULT_SEP or call the low-level dump method.

    -

    The mark used with the {depth_marks} tag can be configured with the depth_mark method, and its default with the CLUTCHLOG_DEFAULT_DEPTH_MARK macro:

    log.depth_mark(CLUTCHLOG_DEFAULT_DEPTH_MARK); // Defaults to ">".
    +

    The mark used with the {depth_marks} tag can be configured with the depth_mark method, and its default with the CLUTCHLOG_DEFAULT_DEPTH_MARK macro:

    log.depth_mark(CLUTCHLOG_DEFAULT_DEPTH_MARK); // Defaults to ">".

    By default, clutchlog removes 5 levels of the calls stack, so that your main entrypoint corresponds to a depth of zero. You can change this behaviour by defining the CLUTCHLOG_STRIP_CALLS macro.

    Output style

    @@ -184,9 +184,9 @@ Output style
    log.style(clutchlog::level::warning, warn);

    Using the clutchlog::fmt class, you can style:

    Any of the three arguments may be passed, in any order, if an argument is omitted, it defaults to no color/style.

    Available colors are:

    @@ -222,7 +222,7 @@ Output style Disabled calls

    By default, clutchlog is always enabled if the NDEBUG preprocessor variable is not defined (this variable is set by CMake in build types that differs from Debug).

    You can however force clutchlog to be enabled in any build type by setting the WITH_CLUTCHLOG preprocessor variable.

    -

    When the NDEBUG preprocessor variable is set (e.g. in Release build), clutchlog will do its best to allow the compiler to optimize out any calls for log levels which are under or equal to progress.

    +

    When the NDEBUG preprocessor variable is set (e.g. in Release build), clutchlog will do its best to allow the compiler to optimize out any calls for log levels that are under or equal to progress.

    You can change this behavior at compile time by setting the CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG preprocessor variable to the desired maximum log level, for example:

    // Will always allow to log everything even in Release mode.
    #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::xdebug

    Note that allowing a log level does not mean that it will actually output something. If the configured log level at runtime is lower than the log level of the message, it will still not be printed.

    @@ -249,14 +249,14 @@ Low-level API Log level semantics

    Log levels use a classical semantics for a human skilled in the art, in decreasing order of importance:

      -
    • Critical: an error which cannot be recovered. For instance, something which will make a server stop right here.
      • -
    • Error: an error which invalidates a function, but may still be recovered. For example, a bad user input which will make a server reset its state, but not crash.
      • +
    • Critical: an error that cannot be recovered. For instance, something which will make a server stop right here.
      • +
    • Error: an error that invalidates a function, but may still be recovered. For example, a bad user input that will make a server reset its state, but not crash.
    • Warning: something that is strange, but is probably legit. For example a default parameter is set because the user forgot to indicate its preference.
    • Progress: the state at which computation currently is.
    • Note: some state worth noting to understand what's going on.
      • -
    • Info: any information which would help ensuring that everything is going well.
      • -
    • Debug: data which would help debugging the program if there was a bug later on.
      • -
    • XDebug: debugging information which would be heavy to read.
      • +
    • Info: any information that would help ensuring that everything is going well.
      • +
    • Debug: data that would help debugging the program if there was a bug later on.
      • +
    • XDebug: debugging information that would be heavy to read.

    Note: the log levels constants are lower case (for example: clutchlog::level::xdebug), but their string representation is not (e.g. "XDebug", this should be taken into account when using level_of).

    @@ -295,16 +295,16 @@ Build and tests

    cmake -DCMAKE_BUILD_TYPE=Debug -DWITH_CLUTCHLOG=ON ..
    make
    ctest
    -

    There's a script which tests all the build types combinations: ./build_all.sh.

    +

    There's a script that tests all the build types combinations: ./build_all.sh.

    -
    CLUTCHLOG
    #define CLUTCHLOG(LEVEL, WHAT)
    Log a message at the given level.
    Definition: clutchlog.h:100
    -
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:96
    -
    CLUTCHCODE
    #define CLUTCHCODE(LEVEL,...)
    Run any code if the scope matches.
    Definition: clutchlog.h:155
    -
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:208
    -
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:229
    -
    CLUTCHLOG_DEFAULT_DEPTH_MARK
    #define CLUTCHLOG_DEFAULT_DEPTH_MARK
    Default mark for stack depth.
    Definition: clutchlog.h:78
    -
    CLUTCHDUMP
    #define CLUTCHDUMP(LEVEL, CONTAINER, FILENAME)
    Dump the given container.
    Definition: clutchlog.h:117
    +
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:220
    +
    CLUTCHLOG
    #define CLUTCHLOG(LEVEL, WHAT)
    Log a message at the given level.
    Definition: clutchlog.h:69
    +
    CLUTCHLOG_DEFAULT_DEPTH_MARK
    #define CLUTCHLOG_DEFAULT_DEPTH_MARK
    Default mark for stack depth.
    Definition: clutchlog.h:198
    +
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:65
    +
    CLUTCHCODE
    #define CLUTCHCODE(LEVEL,...)
    Run any code if the scope matches.
    Definition: clutchlog.h:123
    +
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:241
    +
    CLUTCHDUMP
    #define CLUTCHDUMP(LEVEL, CONTAINER, FILENAME)
    Dump the given container.
    Definition: clutchlog.h:86
    Generated by   diff --git a/docs/modules.html b/docs/modules.html index 0b5ee1d..17f0f58 100644 --- a/docs/modules.html +++ b/docs/modules.html @@ -67,11 +67,11 @@ $(function() {
    Here is a list of all modules:
    - +
    [detail level 12]
    - - - + + +
     Default configuration macros
     High-level API macros
     Main classThe single class which holds everything
     Formating tools
     ▼High-level API macros
     Formating tools
     Main classThe single class which holds everything
    diff --git a/docs/search/all_0.js b/docs/search/all_0.js index cd67961..5a69d57 100644 --- a/docs/search/all_0.js +++ b/docs/search/all_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['bg_0',['bg',['../classclutchlog_1_1fmt.html#a1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] + ['bg_0',['bg',['../group__UseMacros.html#ga1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_1.js b/docs/search/all_1.js index c4ead91..6d51417 100644 --- a/docs/search/all_1.js +++ b/docs/search/all_1.js @@ -2,14 +2,15 @@ var searchData= [ ['clutchcode_1',['CLUTCHCODE',['../group__UseMacros.html#gaaf2e85e1153e6c88b458dd49e3c37c73',1,'clutchlog.h']]], ['clutchdump_2',['CLUTCHDUMP',['../group__UseMacros.html#ga572e3aa19d8b39e3ed0b9e91961104c2',1,'clutchlog.h']]], - ['clutchdump_5fdefault_5fformat_3',['CLUTCHDUMP_DEFAULT_FORMAT',['../group__DefaultConfigMacros.html#ga27b613c6727857a7cbcd0165d862034e',1,'clutchlog.h']]], - ['clutchdump_5fdefault_5fsep_4',['CLUTCHDUMP_DEFAULT_SEP',['../group__DefaultConfigMacros.html#ga54d29e956575e1c731eab5406135c5df',1,'clutchlog.h']]], + ['clutchdump_5fdefault_5fformat_3',['CLUTCHDUMP_DEFAULT_FORMAT',['../group__UseMacros.html#ga27b613c6727857a7cbcd0165d862034e',1,'clutchlog.h']]], + ['clutchdump_5fdefault_5fsep_4',['CLUTCHDUMP_DEFAULT_SEP',['../group__UseMacros.html#ga54d29e956575e1c731eab5406135c5df',1,'clutchlog.h']]], ['clutchfunc_5',['CLUTCHFUNC',['../group__UseMacros.html#ga9f77cee4f853e582262930c9c17f90ae',1,'clutchlog.h']]], ['clutchloc_6',['CLUTCHLOC',['../group__UseMacros.html#gae8911119d726a43b77f5781cb5a72813',1,'clutchlog.h']]], ['clutchlog_7',['clutchlog',['../classclutchlog.html',1,'clutchlog'],['../group__UseMacros.html#ga6f86187e2b35e7e1907d688f504a197d',1,'CLUTCHLOG(): clutchlog.h']]], ['clutchlog_2eh_8',['clutchlog.h',['../clutchlog_8h.html',1,'']]], ['clutchlog_5fdefault_5fdepth_5fbuilt_5fnodebug_9',['CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG',['../group__DefaultConfigMacros.html#ga8564be479b948ee3052b61783c66d415',1,'clutchlog.h']]], - ['clutchlog_5fdefault_5fdepth_5fmark_10',['CLUTCHLOG_DEFAULT_DEPTH_MARK',['../group__DefaultConfigMacros.html#ga45c4c964fad4ad1641d5c9c28c4645b9',1,'clutchlog.h']]], - ['clutchlog_5fdefault_5fformat_11',['CLUTCHLOG_DEFAULT_FORMAT',['../group__DefaultConfigMacros.html#ga524c16f280d92ee8ab683162c9ce01fa',1,'clutchlog.h']]], - ['clutchlog_5fstrip_5fcalls_12',['CLUTCHLOG_STRIP_CALLS',['../group__DefaultConfigMacros.html#ga98f30d814d4913a8a7c93a8793f49adf',1,'clutchlog.h']]] + ['clutchlog_5fdefault_5fdepth_5fmark_10',['CLUTCHLOG_DEFAULT_DEPTH_MARK',['../group__UseMacros.html#ga45c4c964fad4ad1641d5c9c28c4645b9',1,'clutchlog.h']]], + ['clutchlog_5fdefault_5fformat_11',['CLUTCHLOG_DEFAULT_FORMAT',['../group__UseMacros.html#ga524c16f280d92ee8ab683162c9ce01fa',1,'clutchlog.h']]], + ['clutchlog_5fstrip_5fcalls_12',['CLUTCHLOG_STRIP_CALLS',['../group__UseMacros.html#ga98f30d814d4913a8a7c93a8793f49adf',1,'clutchlog.h']]], + ['clutchlog_20—_20versatile_20_28de_29clutchable_20logging_13',['Clutchlog — versatile (de)clutchable logging',['../index.html',1,'']]] ]; diff --git a/docs/search/all_2.js b/docs/search/all_2.js index f674932..1bc183b 100644 --- a/docs/search/all_2.js +++ b/docs/search/all_2.js @@ -1,5 +1,5 @@ var searchData= [ - ['default_20configuration_20macros_13',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]], - ['dump_14',['dump',['../classclutchlog.html#ae7edb2e14f3d55b201b834255aa4bce9',1,'clutchlog']]] + ['default_20configuration_20macros_14',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]], + ['dump_15',['dump',['../group__UseMacros.html#ga63308e8deae3cfec6801318203494143',1,'clutchlog']]] ]; diff --git a/docs/search/all_3.js b/docs/search/all_3.js index 3902c90..9b3d1a3 100644 --- a/docs/search/all_3.js +++ b/docs/search/all_3.js @@ -1,10 +1,10 @@ var searchData= [ - ['fg_15',['fg',['../classclutchlog_1_1fmt.html#a4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]], - ['file_16',['file',['../classclutchlog.html#a10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], - ['fmt_17',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog::fmt'],['../classclutchlog_1_1fmt.html#a407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt::fmt()']]], - ['format_18',['format',['../classclutchlog.html#a656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../classclutchlog.html#afc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../classclutchlog.html#af1219599b1361562c802779572aa669f',1,'clutchlog::format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], - ['format_5fcomment_19',['format_comment',['../classclutchlog.html#a2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../classclutchlog.html#aa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], - ['formating_20tools_20',['Formating tools',['../group__Formating.html',1,'']]], - ['func_21',['func',['../classclutchlog.html#ad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] + ['fg_16',['fg',['../group__UseMacros.html#ga4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]], + ['file_17',['file',['../group__UseMacros.html#ga10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], + ['fmt_18',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog::fmt'],['../group__UseMacros.html#ga407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt::fmt()']]], + ['format_19',['format',['../group__UseMacros.html#ga656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../group__UseMacros.html#gafc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../group__UseMacros.html#gaf1219599b1361562c802779572aa669f',1,'clutchlog::format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], + ['format_5fcomment_20',['format_comment',['../group__UseMacros.html#ga2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../group__UseMacros.html#gaa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], + ['formating_20tools_21',['Formating tools',['../group__Formating.html',1,'']]], + ['func_22',['func',['../group__UseMacros.html#gad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] ]; diff --git a/docs/search/all_4.js b/docs/search/all_4.js index bb6d96d..2b03239 100644 --- a/docs/search/all_4.js +++ b/docs/search/all_4.js @@ -1,4 +1,4 @@ var searchData= [ - ['high_2dlevel_20api_20macros_22',['High-level API macros',['../group__UseMacros.html',1,'']]] + ['high_2dlevel_20api_20macros_23',['High-level API macros',['../group__UseMacros.html',1,'']]] ]; diff --git a/docs/search/all_5.js b/docs/search/all_5.js index e15dace..08ce007 100644 --- a/docs/search/all_5.js +++ b/docs/search/all_5.js @@ -1,10 +1,10 @@ var searchData= [ - ['level_23',['level',['../classclutchlog.html#a10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]], - ['level_5fof_24',['level_of',['../classclutchlog.html#acebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], - ['line_25',['line',['../classclutchlog.html#aa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], - ['locate_26',['locate',['../classclutchlog.html#a4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], - ['location_27',['location',['../classclutchlog.html#a6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], - ['log_28',['log',['../classclutchlog.html#a23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], - ['logger_29',['logger',['../classclutchlog.html#acfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] + ['level_24',['level',['../group__UseMacros.html#ga10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]], + ['level_5fof_25',['level_of',['../group__UseMacros.html#gacebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], + ['line_26',['line',['../group__UseMacros.html#gaa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], + ['locate_27',['locate',['../group__UseMacros.html#ga4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], + ['location_28',['location',['../group__UseMacros.html#ga6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], + ['log_29',['log',['../group__UseMacros.html#ga23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], + ['logger_30',['logger',['../group__UseMacros.html#gacfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] ]; diff --git a/docs/search/all_6.js b/docs/search/all_6.js index e21a5e1..b52d791 100644 --- a/docs/search/all_6.js +++ b/docs/search/all_6.js @@ -1,4 +1,4 @@ var searchData= [ - ['main_20class_30',['Main class',['../group__Main.html',1,'']]] + ['main_20class_31',['Main class',['../group__Main.html',1,'']]] ]; diff --git a/docs/search/all_7.js b/docs/search/all_7.js index def18b6..e2ab931 100644 --- a/docs/search/all_7.js +++ b/docs/search/all_7.js @@ -1,6 +1,6 @@ var searchData= [ - ['operator_28_29_31',['operator()',['../classclutchlog_1_1fmt.html#afeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], - ['operator_3c_3c_32',['operator<<',['../classclutchlog_1_1fmt.html#a96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]], - ['out_33',['out',['../classclutchlog.html#a7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../classclutchlog.html#a6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] + ['operator_28_29_32',['operator()',['../group__UseMacros.html#gafeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], + ['operator_3c_3c_33',['operator<<',['../group__UseMacros.html#ga96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]], + ['out_34',['out',['../group__UseMacros.html#ga7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../group__UseMacros.html#ga6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] ]; diff --git a/docs/search/all_8.js b/docs/search/all_8.js index da1dc37..9b78b21 100644 --- a/docs/search/all_8.js +++ b/docs/search/all_8.js @@ -1,4 +1,4 @@ var searchData= [ - ['print_5fon_34',['print_on',['../classclutchlog_1_1fmt.html#a0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] + ['print_5fon_35',['print_on',['../group__UseMacros.html#ga0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_9.js b/docs/search/all_9.js index fa0f7c1..89e955a 100644 --- a/docs/search/all_9.js +++ b/docs/search/all_9.js @@ -1,4 +1,4 @@ var searchData= [ - ['replace_35',['replace',['../classclutchlog.html#a972f895c70edc335f3018a2c8971d59e',1,'clutchlog::replace(const std::string &form, const std::string &mark, const std::string &tag) const'],['../classclutchlog.html#ae90d5a1a428587ad67b38b2ea4ca9fa2',1,'clutchlog::replace(const std::string &form, const std::string &mark, const size_t tag) const']]] + ['replace_36',['replace',['../group__UseMacros.html#ga972f895c70edc335f3018a2c8971d59e',1,'clutchlog::replace(const std::string &form, const std::string &mark, const std::string &tag) const'],['../group__UseMacros.html#gae90d5a1a428587ad67b38b2ea4ca9fa2',1,'clutchlog::replace(const std::string &form, const std::string &mark, const size_t tag) const']]] ]; diff --git a/docs/search/all_a.js b/docs/search/all_a.js index 71d6a39..bd627ae 100644 --- a/docs/search/all_a.js +++ b/docs/search/all_a.js @@ -1,5 +1,5 @@ var searchData= [ - ['scope_5ft_36',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]], - ['style_37',['style',['../classclutchlog.html#ac3ec55057b9c734b66f169bf43dbd591',1,'clutchlog::style(level stage, FMT... styles)'],['../classclutchlog.html#ad1cfa9945c3f7f98fe8ce724c627d0d6',1,'clutchlog::style(level stage, fmt style)'],['../classclutchlog.html#a4831f44fd5ade102e57320632095934d',1,'clutchlog::style(level stage) const']]] + ['scope_5ft_37',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]], + ['style_38',['style',['../group__UseMacros.html#gac3ec55057b9c734b66f169bf43dbd591',1,'clutchlog::style(level stage, FMT... styles)'],['../group__UseMacros.html#gad1cfa9945c3f7f98fe8ce724c627d0d6',1,'clutchlog::style(level stage, fmt style)'],['../group__UseMacros.html#ga4831f44fd5ade102e57320632095934d',1,'clutchlog::style(level stage) const']]] ]; diff --git a/docs/search/all_b.js b/docs/search/all_b.js index eb749a8..3a373c1 100644 --- a/docs/search/all_b.js +++ b/docs/search/all_b.js @@ -1,5 +1,5 @@ var searchData= [ - ['threshold_38',['threshold',['../classclutchlog.html#a3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../classclutchlog.html#ab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]], - ['typo_39',['typo',['../classclutchlog_1_1fmt.html#a932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] + ['threshold_39',['threshold',['../group__UseMacros.html#ga3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../group__UseMacros.html#gab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]], + ['typo_40',['typo',['../group__UseMacros.html#ga932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_c.js b/docs/search/all_c.js index 7d2b195..9e9ac63 100644 --- a/docs/search/all_c.js +++ b/docs/search/all_c.js @@ -1,4 +1,4 @@ var searchData= [ - ['with_5fclutchlog_40',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] + ['with_5fclutchlog_41',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] ]; diff --git a/docs/search/classes_0.js b/docs/search/classes_0.js index 7f0c958..8e32800 100644 --- a/docs/search/classes_0.js +++ b/docs/search/classes_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['clutchlog_41',['clutchlog',['../classclutchlog.html',1,'']]] + ['clutchlog_42',['clutchlog',['../classclutchlog.html',1,'']]] ]; diff --git a/docs/search/classes_1.js b/docs/search/classes_1.js index dd02d25..34f7502 100644 --- a/docs/search/classes_1.js +++ b/docs/search/classes_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['fmt_42',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog']]] + ['fmt_43',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog']]] ]; diff --git a/docs/search/classes_2.js b/docs/search/classes_2.js index 618c31d..3671680 100644 --- a/docs/search/classes_2.js +++ b/docs/search/classes_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['scope_5ft_43',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]] + ['scope_5ft_44',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]] ]; diff --git a/docs/search/enums_0.js b/docs/search/enums_0.js index 058cb9d..de0347c 100644 --- a/docs/search/enums_0.js +++ b/docs/search/enums_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['bg_63',['bg',['../classclutchlog_1_1fmt.html#a1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] + ['bg_64',['bg',['../group__UseMacros.html#ga1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/enums_1.js b/docs/search/enums_1.js index 529d6d1..d1b826e 100644 --- a/docs/search/enums_1.js +++ b/docs/search/enums_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['fg_64',['fg',['../classclutchlog_1_1fmt.html#a4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]] + ['fg_65',['fg',['../group__UseMacros.html#ga4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/enums_2.js b/docs/search/enums_2.js index b901f64..8b50c84 100644 --- a/docs/search/enums_2.js +++ b/docs/search/enums_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['level_65',['level',['../classclutchlog.html#a10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]] + ['level_66',['level',['../group__UseMacros.html#ga10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]] ]; diff --git a/docs/search/enums_3.js b/docs/search/enums_3.js index d3a77ff..9ead27f 100644 --- a/docs/search/enums_3.js +++ b/docs/search/enums_3.js @@ -1,4 +1,4 @@ var searchData= [ - ['typo_66',['typo',['../classclutchlog_1_1fmt.html#a932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] + ['typo_67',['typo',['../group__UseMacros.html#ga932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/files_0.js b/docs/search/files_0.js index a5d5b56..b4cd056 100644 --- a/docs/search/files_0.js +++ b/docs/search/files_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['clutchlog_2eh_44',['clutchlog.h',['../clutchlog_8h.html',1,'']]] + ['clutchlog_2eh_45',['clutchlog.h',['../clutchlog_8h.html',1,'']]] ]; diff --git a/docs/search/functions_0.js b/docs/search/functions_0.js index 9a55b24..7206bbb 100644 --- a/docs/search/functions_0.js +++ b/docs/search/functions_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['dump_45',['dump',['../classclutchlog.html#ae7edb2e14f3d55b201b834255aa4bce9',1,'clutchlog']]] + ['dump_46',['dump',['../group__UseMacros.html#ga63308e8deae3cfec6801318203494143',1,'clutchlog']]] ]; diff --git a/docs/search/functions_1.js b/docs/search/functions_1.js index aef2058..077db01 100644 --- a/docs/search/functions_1.js +++ b/docs/search/functions_1.js @@ -1,8 +1,8 @@ var searchData= [ - ['file_46',['file',['../classclutchlog.html#a10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], - ['fmt_47',['fmt',['../classclutchlog_1_1fmt.html#a407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt']]], - ['format_48',['format',['../classclutchlog.html#a656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../classclutchlog.html#afc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../classclutchlog.html#af1219599b1361562c802779572aa669f',1,'clutchlog::format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], - ['format_5fcomment_49',['format_comment',['../classclutchlog.html#a2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../classclutchlog.html#aa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], - ['func_50',['func',['../classclutchlog.html#ad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] + ['file_47',['file',['../group__UseMacros.html#ga10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], + ['fmt_48',['fmt',['../group__UseMacros.html#ga407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt']]], + ['format_49',['format',['../group__UseMacros.html#ga656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../group__UseMacros.html#gafc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../group__UseMacros.html#gaf1219599b1361562c802779572aa669f',1,'clutchlog::format(std::string format, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], + ['format_5fcomment_50',['format_comment',['../group__UseMacros.html#ga2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../group__UseMacros.html#gaa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], + ['func_51',['func',['../group__UseMacros.html#gad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] ]; diff --git a/docs/search/functions_2.js b/docs/search/functions_2.js index cceee06..a4ebbc6 100644 --- a/docs/search/functions_2.js +++ b/docs/search/functions_2.js @@ -1,9 +1,9 @@ var searchData= [ - ['level_5fof_51',['level_of',['../classclutchlog.html#acebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], - ['line_52',['line',['../classclutchlog.html#aa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], - ['locate_53',['locate',['../classclutchlog.html#a4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], - ['location_54',['location',['../classclutchlog.html#a6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], - ['log_55',['log',['../classclutchlog.html#a23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], - ['logger_56',['logger',['../classclutchlog.html#acfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] + ['level_5fof_52',['level_of',['../group__UseMacros.html#gacebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], + ['line_53',['line',['../group__UseMacros.html#gaa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], + ['locate_54',['locate',['../group__UseMacros.html#ga4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], + ['location_55',['location',['../group__UseMacros.html#ga6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], + ['log_56',['log',['../group__UseMacros.html#ga23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], + ['logger_57',['logger',['../group__UseMacros.html#gacfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] ]; diff --git a/docs/search/functions_3.js b/docs/search/functions_3.js index 4a5a069..d756880 100644 --- a/docs/search/functions_3.js +++ b/docs/search/functions_3.js @@ -1,5 +1,5 @@ var searchData= [ - ['operator_28_29_57',['operator()',['../classclutchlog_1_1fmt.html#afeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], - ['out_58',['out',['../classclutchlog.html#a7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../classclutchlog.html#a6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] + ['operator_28_29_58',['operator()',['../group__UseMacros.html#gafeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], + ['out_59',['out',['../group__UseMacros.html#ga7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../group__UseMacros.html#ga6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] ]; diff --git a/docs/search/functions_4.js b/docs/search/functions_4.js index 58b5b12..f818205 100644 --- a/docs/search/functions_4.js +++ b/docs/search/functions_4.js @@ -1,4 +1,4 @@ var searchData= [ - ['print_5fon_59',['print_on',['../classclutchlog_1_1fmt.html#a0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] + ['print_5fon_60',['print_on',['../group__UseMacros.html#ga0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/functions_5.js b/docs/search/functions_5.js index 31e1e94..41c0ace 100644 --- a/docs/search/functions_5.js +++ b/docs/search/functions_5.js @@ -1,4 +1,4 @@ var searchData= [ - ['replace_60',['replace',['../classclutchlog.html#a972f895c70edc335f3018a2c8971d59e',1,'clutchlog::replace(const std::string &form, const std::string &mark, const std::string &tag) const'],['../classclutchlog.html#ae90d5a1a428587ad67b38b2ea4ca9fa2',1,'clutchlog::replace(const std::string &form, const std::string &mark, const size_t tag) const']]] + ['replace_61',['replace',['../group__UseMacros.html#ga972f895c70edc335f3018a2c8971d59e',1,'clutchlog::replace(const std::string &form, const std::string &mark, const std::string &tag) const'],['../group__UseMacros.html#gae90d5a1a428587ad67b38b2ea4ca9fa2',1,'clutchlog::replace(const std::string &form, const std::string &mark, const size_t tag) const']]] ]; diff --git a/docs/search/functions_6.js b/docs/search/functions_6.js index 0a7bb4e..5227036 100644 --- a/docs/search/functions_6.js +++ b/docs/search/functions_6.js @@ -1,4 +1,4 @@ var searchData= [ - ['style_61',['style',['../classclutchlog.html#ac3ec55057b9c734b66f169bf43dbd591',1,'clutchlog::style(level stage, FMT... styles)'],['../classclutchlog.html#ad1cfa9945c3f7f98fe8ce724c627d0d6',1,'clutchlog::style(level stage, fmt style)'],['../classclutchlog.html#a4831f44fd5ade102e57320632095934d',1,'clutchlog::style(level stage) const']]] + ['style_62',['style',['../group__UseMacros.html#gac3ec55057b9c734b66f169bf43dbd591',1,'clutchlog::style(level stage, FMT... styles)'],['../group__UseMacros.html#gad1cfa9945c3f7f98fe8ce724c627d0d6',1,'clutchlog::style(level stage, fmt style)'],['../group__UseMacros.html#ga4831f44fd5ade102e57320632095934d',1,'clutchlog::style(level stage) const']]] ]; diff --git a/docs/search/functions_7.js b/docs/search/functions_7.js index 4cb6b92..379582c 100644 --- a/docs/search/functions_7.js +++ b/docs/search/functions_7.js @@ -1,4 +1,4 @@ var searchData= [ - ['threshold_62',['threshold',['../classclutchlog.html#a3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../classclutchlog.html#ab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]] + ['threshold_63',['threshold',['../group__UseMacros.html#ga3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../group__UseMacros.html#gab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]] ]; diff --git a/docs/search/groups_0.js b/docs/search/groups_0.js index 96d788d..ae890af 100644 --- a/docs/search/groups_0.js +++ b/docs/search/groups_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['default_20configuration_20macros_69',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]] + ['default_20configuration_20macros_70',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]] ]; diff --git a/docs/search/groups_1.js b/docs/search/groups_1.js index de18979..7e3884a 100644 --- a/docs/search/groups_1.js +++ b/docs/search/groups_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['formating_20tools_70',['Formating tools',['../group__Formating.html',1,'']]] + ['formating_20tools_71',['Formating tools',['../group__Formating.html',1,'']]] ]; diff --git a/docs/search/groups_2.js b/docs/search/groups_2.js index 0c462ce..081e3fc 100644 --- a/docs/search/groups_2.js +++ b/docs/search/groups_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['high_2dlevel_20api_20macros_71',['High-level API macros',['../group__UseMacros.html',1,'']]] + ['high_2dlevel_20api_20macros_72',['High-level API macros',['../group__UseMacros.html',1,'']]] ]; diff --git a/docs/search/groups_3.js b/docs/search/groups_3.js index e594c17..0981133 100644 --- a/docs/search/groups_3.js +++ b/docs/search/groups_3.js @@ -1,4 +1,4 @@ var searchData= [ - ['main_20class_72',['Main class',['../group__Main.html',1,'']]] + ['main_20class_73',['Main class',['../group__Main.html',1,'']]] ]; diff --git a/docs/search/related_0.js b/docs/search/related_0.js index 14fe351..8f56727 100644 --- a/docs/search/related_0.js +++ b/docs/search/related_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['operator_3c_3c_67',['operator<<',['../classclutchlog_1_1fmt.html#a96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]] + ['operator_3c_3c_68',['operator<<',['../group__UseMacros.html#ga96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/searchdata.js b/docs/search/searchdata.js index 7ff50c3..c9b3793 100644 --- a/docs/search/searchdata.js +++ b/docs/search/searchdata.js @@ -7,7 +7,8 @@ var indexSectionsWithContent = 4: "bflt", 5: "o", 6: "w", - 7: "dfhm" + 7: "dfhm", + 8: "c" }; var indexSectionNames = @@ -19,7 +20,8 @@ var indexSectionNames = 4: "enums", 5: "related", 6: "defines", - 7: "groups" + 7: "groups", + 8: "pages" }; var indexSectionLabels = @@ -31,6 +33,7 @@ var indexSectionLabels = 4: "Enumerations", 5: "Friends", 6: "Macros", - 7: "Modules" + 7: "Modules", + 8: "Pages" }; diff --git a/docs/structclutchlog_1_1scope__t.html b/docs/structclutchlog_1_1scope__t.html index f7ade8c..af9cbd7 100644 --- a/docs/structclutchlog_1_1scope__t.html +++ b/docs/structclutchlog_1_1scope__t.html @@ -70,7 +70,7 @@ $(function() {     Public Attributes | List of all members
    -
    clutchlog::scope_t Struct Reference
    +
    clutchlog::scope_t Struct Reference
    High-level API macros
    @@ -81,15 +81,15 @@ $(function() { - - - - - + + + - +

    Public Attributes

    +
    bool matches
     
    -level stage
     
    +
     
    +level stage
     
    bool there
     
     

    Detailed Description

    Structure holding a location matching.

    diff --git a/tests/t-assert.cpp b/tests/t-assert.cpp index b240ac5..28ea449 100644 --- a/tests/t-assert.cpp +++ b/tests/t-assert.cpp @@ -4,7 +4,7 @@ #include "../clutchlog/clutchlog.h" // Make asserts (de)clutchable. -#define ASSERT(LEVEL, ...) { CLUTCHFUNC(LEVEL, assert, __VA_ARGS__) } +#define ASSERT(LEVEL, ...) CLUTCHFUNC(LEVEL, assert, __VA_ARGS__); void h() {