diff --git a/CMakeLists.txt b/CMakeLists.txt index b1e87cb..0d4539d 100644 --- a/CMakeLists.txt +++ b/CMakeLists.txt @@ -6,19 +6,19 @@ cmake_minimum_required(VERSION 3.10 FATAL_ERROR) project("clutchlog" - VERSION 0.10 + VERSION 0.11 DESCRIPTION "A logging system which targets versatile debugging") enable_language(CXX) # C++ set(CMAKE_CXX_STANDARD 17) -if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU") +if (CMAKE_CXX_COMPILER_ID STREQUAL "GNU") SET(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -Wextra -pedantic -std=c++17 -lstdc++fs") if(CMAKE_CXX_COMPILER_VERSION VERSION_GREATER 6.0 AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 9.0) link_libraries(stdc++fs) add_compile_definitions(FSEXPERIMENTAL) endif() -endif() +endif() ###################################################################################### diff --git a/README.md b/README.md index 88733e9..578f04b 100644 --- a/README.md +++ b/README.md @@ -190,7 +190,8 @@ Available tags are: - `{level_letter}`: the first letter of the current log level, - `{file}`: the current file (absolute path), - `{func}`: the current function, -- `{line}`: the current line number. +- `{line}`: the current line number, +- `{level_fmt}`: the format of the current level (i.e. configured with `clutchlog::style`). Some tags are only available on POSIX operating systems as of now: - `{name}`: the name of the current binary, diff --git a/docs/annotated.html b/docs/annotated.html index d1602d8..7884bea 100644 --- a/docs/annotated.html +++ b/docs/annotated.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -68,7 +68,7 @@ $(function() {
Here are the classes, structs, unions and interfaces with brief descriptions:
[detail level 12]
- +
 ▼Cclutchlog
 ▼CclutchlogThe single class which holds everything
 CfmtColor and style formatter for ANSI terminal escape sequences
 Cscope_tStructure holding a location matching
diff --git a/docs/classclutchlog-members.html b/docs/classclutchlog-members.html index 8902b65..45de837 100644 --- a/docs/classclutchlog-members.html +++ b/docs/classclutchlog-members.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -69,58 +69,58 @@ $(function() {

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

- - - - - - - - - - - + + + + + + + + + + + - - - - - - - - + + + + + + + + - - - - - - - + + + + + + + - - - - - - - - + + + + + + + + - - + + - - - - - - - - + + + + + + + +
_format_dumpclutchlogprotected
_format_logclutchlogprotected
_in_fileclutchlogprotected
_in_funcclutchlogprotected
_in_lineclutchlogprotected
_level_fmtclutchlogprotected
_level_wordclutchlogprotected
_outclutchlogprotected
_stageclutchlogprotected
_strip_callsclutchlogprotected
_word_levelclutchlogprotected
_format_dumpclutchlogprotected
_format_logclutchlogprotected
_in_fileclutchlogprotected
_in_funcclutchlogprotected
_in_lineclutchlogprotected
_level_fmtclutchlogprotected
_level_wordclutchlogprotected
_outclutchlogprotected
_stageclutchlogprotected
_strip_callsclutchlogprotected
_word_levelclutchlogprotected
clutchlog(clutchlog const &)=delete (defined in clutchlog)clutchlog
critical enum value (defined in clutchlog)clutchlog
debug enum value (defined in clutchlog)clutchlog
default_depth_markclutchloginlineprotectedstatic
default_formatclutchloginlineprotectedstatic
default_hfill_charclutchloginlineprotectedstatic
default_hfill_maxclutchloginlineprotectedstatic
default_strip_callsclutchloginlineprotectedstatic
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_formatclutchloginlineprotectedstatic
dump_default_sepclutchloginlineprotectedstatic
default_depth_markclutchloginlineprotectedstatic
default_formatclutchloginlineprotectedstatic
default_hfill_charclutchloginlineprotectedstatic
default_hfill_maxclutchloginlineprotectedstatic
default_strip_callsclutchloginlineprotectedstatic
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_formatclutchloginlineprotectedstatic
dump_default_sepclutchloginlineprotectedstatic
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 row, 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
levels() constclutchloginline
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
levels() constclutchloginline
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
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(const std::string &l)clutchloginline
threshold() constclutchloginline
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(const std::string &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 0196391..e171444 100644 --- a/docs/classclutchlog.html +++ b/docs/classclutchlog.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -64,12 +64,16 @@ $(function() {
Classes | -Static Protected Attributes | List of all members
clutchlog Class Reference
Main class
+ +

The single class which holds everything. + More...

+ +

#include <clutchlog.h>

@@ -83,137 +87,138 @@ Classes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + - - - + + +

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) with an identifier.
 
-void threshold (const std::string &l)
 Set the log level (below which logs are not printed) with a string.
 
-level threshold () const
 Get the log level below which logs are not printed.
 
-const std::map< std::string, level > & levels () const
 Get the map of available log levels string representations toward their identifier. *‍/.
 
level level_of (const std::string name)
 Return the log level tag corresponding to the given pre-configured name. More...
 
-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.
 
+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) with an identifier.
 
+void threshold (const std::string &l)
 Set the log level (below which logs are not printed) with a string.
 
+level threshold () const
 Get the log level below which logs are not printed.
 
+const std::map< std::string, level > & levels () const
 Get the map of available log levels string representations toward their identifier. *‍/.
 
level level_of (const std::string name)
 Return the log level tag corresponding to the given pre-configured name. More...
 
+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.
 
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 row, 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=dump_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
 Default format of the messages.
 
-static std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
 Default format of the comment line in file dump.
 
-static std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
 Default item separator for dump.
 
-static std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
 Default mark for stack depth.
 
-static unsigned int default_strip_calls = CLUTCHLOG_STRIP_CALLS
 Number of call stack levels to remove from depth display by default.
 
-static char default_hfill_char = CLUTCHLOG_HFILL_MARK
 Default character used as a filling for right-align the right part of messages with "{hfill}".
 
-static unsigned short default_hfill_max = CLUTCHLOG_HFILL_MAX
 Default maximum number of character used as a filling for right-align the right part of messages with "{hfill}".
 
Default configuration members
+static std::string default_format = CLUTCHLOG_DEFAULT_FORMAT
 Default format of the messages.
 
+static std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
 Default format of the comment line in file dump.
 
+static std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
 Default item separator for dump.
 
+static std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
 Default mark for stack depth.
 
+static unsigned int default_strip_calls = CLUTCHLOG_STRIP_CALLS
 Number of call stack levels to remove from depth display by default.
 
+static char default_hfill_char = CLUTCHLOG_HFILL_MARK
 Default character used as a filling for right-align the right part of messages with "{hfill}".
 
+static size_t default_hfill_max = CLUTCHLOG_HFILL_MAX
 Default maximum number of character used as a filling for right-align the right part of messages with "{hfill}".
 
-xdebug =7
} - - - - - + + + + +

High-level API

enum  level {
+
enum  level {
  critical =0, error =1, warning =2, @@ -225,69 +230,219 @@ 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

-size_t _strip_calls
 Current number of call stack levels to remove from depth display.
 
-const std::map< level, std::string > _level_word
 Dictionary of level identifier to their string representation.
 
-std::map< std::string, level > _word_level
 Dictionary of level string to their identifier.
 
-std::map< level, fmt > _level_fmt
 Dictionary of level identifier to their format.
 
-std::string _format_log
 Current format of the standard output.
 
-std::string _format_dump
 Current format of the file output.
 
-std::ostream * _out
 Standard output.
 
-level _stage
 Current log level.
 
-std::regex _in_file
 Current file location filter.
 
-std::regex _in_func
 Current function location filter.
 
-std::regex _in_line
 Current line location filter.
 
+
+size_t _strip_calls
 Current number of call stack levels to remove from depth display.
 
+const std::map< level, std::string > _level_word
 Dictionary of level identifier to their string representation.
 
+std::map< std::string, level > _word_level
 Dictionary of level string to their identifier.
 
+std::map< level, fmt > _level_fmt
 Dictionary of level identifier to their format.
 
+std::string _format_log
 Current format of the standard output.
 
+std::string _format_dump
 Current format of the file output.
 
+std::ostream * _out
 Standard output.
 
+level _stage
 Current log level.
 
+std::regex _in_file
 Current file location filter.
 
+std::regex _in_func
 Current function location filter.
 
+std::regex _in_line
 Current line location filter.
 
 clutchlog (clutchlog const &)=delete
 
+
 
void operator= (clutchlog const &)=delete
 
 
+

Detailed Description

+

The single class which holds everything.

+

This is a Singleton class.

+

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:883
+
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:291
Generated by   diff --git a/docs/classclutchlog_1_1fmt-members.html b/docs/classclutchlog_1_1fmt-members.html index 41807a5..a91dbb0 100644 --- a/docs/classclutchlog_1_1fmt-members.html +++ b/docs/classclutchlog_1_1fmt-members.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -73,22 +73,23 @@ $(function() {

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

- - - - + + + + - - - - - - + + + + + + +
backclutchlog::fmt
bg enum nameclutchlog::fmt
fg enum nameclutchlog::fmt
fmt()clutchlog::fmtinline
backclutchlog::fmt
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(bg b, typo s, fg f=fg::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
foreclutchlog::fmt
operator()(const std::string &msg) constclutchlog::fmtinline
operator<<(std::ostream &os, const fmt &fmt)clutchlog::fmtfriend
print_on(std::ostream &os) constclutchlog::fmtinlineprotected
styleclutchlog::fmt
typo enum nameclutchlog::fmt
foreclutchlog::fmt
operator()(const std::string &msg) constclutchlog::fmtinline
operator<<(std::ostream &os, const fmt &fmt)clutchlog::fmtfriend
print_on(std::ostream &os) constclutchlog::fmtinlineprotected
str() constclutchlog::fmtinline
styleclutchlog::fmt
typo enum nameclutchlog::fmt
diff --git a/docs/classclutchlog_1_1fmt.html b/docs/classclutchlog_1_1fmt.html index df0353d..1007adf 100644 --- a/docs/classclutchlog_1_1fmt.html +++ b/docs/classclutchlog_1_1fmt.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -74,7 +74,7 @@ $(function() { Friends | List of all members
-
clutchlog::fmt Class Reference
High-level API macros » Formating tools
+
clutchlog::fmt Class Reference
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,73 +126,153 @@ 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...
 
+std::string str () const
 Return the formatting code as a string.
 
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
 Foreground color.
 
-enum clutchlog::fmt::bg back
 Background color.
 
-enum clutchlog::fmt::typo style
 Typographic style.
 
+enum clutchlog::fmt::fg fore
 Foreground color.
 
+enum clutchlog::fmt::bg back
 Background color.
 
+enum clutchlog::fmt::typo style
 Typographic 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.
-
The documentation for this class was generated from the following file:
    +

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: +
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:309
Generated by   diff --git a/docs/classes.html b/docs/classes.html index a6166ff..9789990 100644 --- a/docs/classes.html +++ b/docs/classes.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/clutchlog_8h.html b/docs/clutchlog_8h.html index fae49df..2767ab8 100644 --- a/docs/clutchlog_8h.html +++ b/docs/clutchlog_8h.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -109,6 +109,7 @@ Include dependency graph for clutchlog.h:

Classes

class  clutchlog + The single class which holds everything. More...
  class  clutchlog::fmt  Color and style formatter for ANSI terminal escape sequences. More...
@@ -120,21 +121,23 @@ Classes

Macros

-#define CLUTCHLOG_H +#define CLUTCHLOG_H + Header guard.
  #define CLUTCHLOG_HAVE_UNIX_SYSINFO   0 - POSIX headers necessary for stack depth management are available.
+ True if POSIX headers necessary for stack depth management are available.
  -#define CLUTCHLOG_HAVE_UNIX_SYSIOCTL   0 +#define CLUTCHLOG_HAVE_UNIX_SYSIOCTL   0 + True if the system can handle the hfill feature.
  #define WITH_CLUTCHLOG  Actually enable clutchlog features.
  -#define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG   clutchlog::level::progress +#define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG   clutchlog::level::progress  Default level over which calls to the logger are optimized out when NDEBUG is defined.
  @@ -153,28 +156,29 @@ Macros #define CLUTCHCODE(LEVEL, ...)  Run any code if the scope matches. More...
  +
Default configuration members
-#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n" +#define CLUTCHLOG_DEFAULT_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"  Compile-time default format of the messages (debug mode: with absolute location).
  -#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}" +#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}"  Compile-time default format of the comment line in file dump.
  -#define CLUTCHDUMP_DEFAULT_SEP   "\n" +#define CLUTCHDUMP_DEFAULT_SEP   "\n"  Compile-time default item separator for dump.
  -#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">" +#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">"  Compile-time default mark for stack depth.
  -#define CLUTCHLOG_STRIP_CALLS   5 +#define CLUTCHLOG_STRIP_CALLS   5  Compile-time number of call stack levels to remove from depth display by default.
  -#define CLUTCHLOG_HFILL_MARK   '.' +#define CLUTCHLOG_HFILL_MARK   '.'  Character used as a filling for right-align the right part of messages with "{hfill}".
  diff --git a/docs/clutchlog_8h_source.html b/docs/clutchlog_8h_source.html index f02a31b..b8b08b9 100644 --- a/docs/clutchlog_8h_source.html +++ b/docs/clutchlog_8h_source.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -73,982 +73,1004 @@ $(function() { Go to the documentation of this file.
1 #pragma once
2 #ifndef CLUTCHLOG_H
3 #define CLUTCHLOG_H
-
4 
-
6 #include <ciso646>
-
7  #ifdef FSEXPERIMENTAL
-
8  #include <experimental/filesystem>
-
9  namespace fs = std::experimental::filesystem;
-
10 #else
-
11  #include <filesystem>
-
12  namespace fs = std::filesystem;
-
13 #endif
-
14 
-
15 #include <iostream>
-
16 #include <sstream>
-
17 #include <fstream>
-
18 #include <cassert>
-
19 #include <cstdlib>
-
20 #include <string>
-
21 #include <limits>
-
22 #include <regex>
-
23 #include <map>
-
24 
-
26 #if __has_include(<execinfo.h>) && __has_include(<stdlib.h>) && __has_include(<libgen.h>)
-
27  #include <execinfo.h> // execinfo
-
28  #include <stdlib.h> // getenv
-
29  #include <libgen.h> // basename
-
30  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 1
-
31 #else
-
32  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 0
-
33 #endif
-
34 
-
35 #if __has_include(<sys/ioctl.h>) && __has_include(<stdio.h>) && __has_include(<unistd.h>)
-
36  #include <sys/ioctl.h>
-
37  #include <stdio.h>
-
38  #include <unistd.h>
-
39  #define CLUTCHLOG_HAVE_UNIX_SYSIOCTL 1
-
40 #else
-
41  #define CLUTCHLOG_HAVE_UNIX_SYSIOCTL 0
-
42 #endif
-
43 
-
44 
-
45 /**********************************************************************
-
46  * Enable by default in Debug builds.
-
47  **********************************************************************/
-
48 #ifndef WITH_CLUTCHLOG
-
49  #ifndef NDEBUG
-
50  #define WITH_CLUTCHLOG
-
52  #endif
-
53 #endif
-
54 
-
55 /**********************************************************************
-
56  * Macros definitions
-
57  **********************************************************************/
-
58 #ifdef WITH_CLUTCHLOG
-
59 
-
63 #ifndef CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG
-
64  #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress
-
66 #endif // CLUTCHLOG_DEFAULT_DEPTH_BUILT
-
67 
-
74 #define CLUTCHLOC __FILE__, __FUNCTION__, __LINE__
-
76 
-
78 #ifndef NDEBUG
-
79  #define CLUTCHLOG( LEVEL, WHAT ) do { \
-
80  auto& clutchlog__logger = clutchlog::logger(); \
-
81  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
-
82  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
-
83  } while(0)
-
84 #else // not Debug build.
-
85  #define CLUTCHLOG( LEVEL, WHAT ) do { \
-
86  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
87  auto& clutchlog__logger = clutchlog::logger(); \
-
88  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
-
89  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
-
90  } \
-
91  } while(0)
-
92 #endif // NDEBUG
-
93 
-
95 #ifndef NDEBUG
-
96  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
-
97  auto& clutchlog__logger = clutchlog::logger(); \
-
98  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
-
99  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
-
100  } while(0)
-
101 #else // not Debug build.
-
102  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
-
103  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
104  auto& clutchlog__logger = clutchlog::logger(); \
-
105  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
-
106  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
-
107  } \
-
108  } while(0)
-
109 #endif // NDEBUG
-
110 
-
112 #ifndef NDEBUG
-
113  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
-
114  auto& clutchlog__logger = clutchlog::logger(); \
-
115  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
116  if(clutchlog__scope.matches) { \
-
117  FUNC(__VA_ARGS__); \
-
118  } \
-
119  } while(0)
-
120 #else // not Debug build.
-
121  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
-
122  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
-
123  auto& clutchlog__logger = clutchlog::logger(); \
-
124  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
-
125  if(clutchlog__scope.matches) { \
-
126  FUNC(__VA_ARGS__); \
-
127  } \
-
128  } \
-
129  } while(0)
-
130 #endif // NDEBUG
-
131 
-
133 #ifndef NDEBUG
-
134  #define CLUTCHCODE( LEVEL, ... ) do { \
-
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  __VA_ARGS__ \
-
139  } \
-
140  } while(0)
-
141 #else // not Debug build.
-
142  #define CLUTCHCODE( LEVEL, CODE ) do { \
-
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  CODE \
-
148  } \
-
149  } \
-
150  } while(0)
-
151 #endif // NDEBUG
-
152 
-
155 #else // not WITH_CLUTCHLOG
-
156  // Disabled macros can still be called in Release builds.
-
157  #define CLUTCHLOG( LEVEL, WHAT ) do {/*nothing*/} while(0)
-
158  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do {/*nothing*/} while(0)
-
159  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do {/*nothing*/} while(0)
-
160  #define CLUTCHCODE( LEVEL, CODE ) do {/*nothing*/} while(0)
-
161 #endif // WITH_CLUTCHLOG
-
162 
-
163 /**********************************************************************
-
164  * Implementation
-
165  **********************************************************************/
-
166 
-
167 #ifdef WITH_CLUTCHLOG
+
5 
+
7 #include <ciso646>
+
8  #ifdef FSEXPERIMENTAL
+
9  #include <experimental/filesystem>
+
10  namespace fs = std::experimental::filesystem;
+
11 #else
+
12  #include <filesystem>
+
13  namespace fs = std::filesystem;
+
14 #endif
+
15 
+
16 #include <iostream>
+
17 #include <sstream>
+
18 #include <fstream>
+
19 #include <cassert>
+
20 #include <cstdlib>
+
21 #include <string>
+
22 #include <limits>
+
23 #include <regex>
+
24 #include <map>
+
25 
+
27 #if __has_include(<execinfo.h>) && __has_include(<stdlib.h>) && __has_include(<libgen.h>)
+
28  #include <execinfo.h> // execinfo
+
29  #include <stdlib.h> // getenv
+
30  #include <libgen.h> // basename
+
31  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 1
+
32 #else
+
33  #define CLUTCHLOG_HAVE_UNIX_SYSINFO 0
+
34 #endif
+
35 
+
37 #if __has_include(<sys/ioctl.h>) && __has_include(<stdio.h>) && __has_include(<unistd.h>)
+
38  #include <sys/ioctl.h>
+
39  #include <stdio.h>
+
40  #include <unistd.h>
+
41  #define CLUTCHLOG_HAVE_UNIX_SYSIOCTL 1
+
42 #else
+
43  #define CLUTCHLOG_HAVE_UNIX_SYSIOCTL 0
+
44 #endif
+
45 
+
46 
+
47 /**********************************************************************
+
48  * Enable by default in Debug builds.
+
49  **********************************************************************/
+
50 #ifndef WITH_CLUTCHLOG
+
51  #ifndef NDEBUG
+
52  #define WITH_CLUTCHLOG
+
54  #endif
+
55 #endif
+
56 
+
57 /**********************************************************************
+
58  * Macros definitions
+
59  **********************************************************************/
+
60 #ifdef WITH_CLUTCHLOG
+
61 
+
65 #ifndef CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG
+
66  #define CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG clutchlog::level::progress
+
68 #endif // CLUTCHLOG_DEFAULT_DEPTH_BUILT
+
69 
+
76 #define CLUTCHLOC __FILE__, __FUNCTION__, __LINE__
+
78 
+
80 #ifndef NDEBUG
+
81  #define CLUTCHLOG( LEVEL, WHAT ) do { \
+
82  auto& clutchlog__logger = clutchlog::logger(); \
+
83  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
+
84  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
+
85  } while(0)
+
86 #else // not Debug build.
+
87  #define CLUTCHLOG( LEVEL, WHAT ) do { \
+
88  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
89  auto& clutchlog__logger = clutchlog::logger(); \
+
90  std::ostringstream clutchlog__msg ; clutchlog__msg << WHAT; \
+
91  clutchlog__logger.log(clutchlog::level::LEVEL, clutchlog__msg.str(), CLUTCHLOC); \
+
92  } \
+
93  } while(0)
+
94 #endif // NDEBUG
+
95 
+
97 #ifndef NDEBUG
+
98  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
+
99  auto& clutchlog__logger = clutchlog::logger(); \
+
100  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
+
101  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
+
102  } while(0)
+
103 #else // not Debug build.
+
104  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do { \
+
105  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
106  auto& clutchlog__logger = clutchlog::logger(); \
+
107  clutchlog__logger.dump(clutchlog::level::LEVEL, std::begin(CONTAINER), std::end(CONTAINER), \
+
108  CLUTCHLOC, FILENAME, CLUTCHDUMP_DEFAULT_SEP); \
+
109  } \
+
110  } while(0)
+
111 #endif // NDEBUG
+
112 
+
114 #ifndef NDEBUG
+
115  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
+
116  auto& clutchlog__logger = clutchlog::logger(); \
+
117  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
118  if(clutchlog__scope.matches) { \
+
119  FUNC(__VA_ARGS__); \
+
120  } \
+
121  } while(0)
+
122 #else // not Debug build.
+
123  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do { \
+
124  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
125  auto& clutchlog__logger = clutchlog::logger(); \
+
126  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
127  if(clutchlog__scope.matches) { \
+
128  FUNC(__VA_ARGS__); \
+
129  } \
+
130  } \
+
131  } while(0)
+
132 #endif // NDEBUG
+
133 
+
135 #ifndef NDEBUG
+
136  #define CLUTCHCODE( LEVEL, ... ) do { \
+
137  auto& clutchlog__logger = clutchlog::logger(); \
+
138  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
139  if(clutchlog__scope.matches) { \
+
140  __VA_ARGS__ \
+
141  } \
+
142  } while(0)
+
143 #else // not Debug build.
+
144  #define CLUTCHCODE( LEVEL, CODE ) do { \
+
145  if(clutchlog::level::LEVEL <= CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG) { \
+
146  auto& clutchlog__logger = clutchlog::logger(); \
+
147  clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
+
148  if(clutchlog__scope.matches) { \
+
149  CODE \
+
150  } \
+
151  } \
+
152  } while(0)
+
153 #endif // NDEBUG
+
154 
+
157 #else // not WITH_CLUTCHLOG
+
158  // Disabled macros can still be called in Release builds.
+
159  #define CLUTCHLOG( LEVEL, WHAT ) do {/*nothing*/} while(0)
+
160  #define CLUTCHDUMP( LEVEL, CONTAINER, FILENAME ) do {/*nothing*/} while(0)
+
161  #define CLUTCHFUNC( LEVEL, FUNC, ... ) do {/*nothing*/} while(0)
+
162  #define CLUTCHCODE( LEVEL, CODE ) do {/*nothing*/} while(0)
+
163 #endif // WITH_CLUTCHLOG
+
164 
+
165 /**********************************************************************
+
166  * Implementation
+
167  **********************************************************************/
168 
-
175 class clutchlog
-
176 {
-
177  protected:
-
178 
-
181  #ifndef NDEBUG
-
182  #ifndef CLUTCHLOG_DEFAULT_FORMAT
-
183  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 // Enables: name, depth and depth_marks
-
185  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 // Enables: hfill
-
186  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg} {hfill} {func} @ {file}:{line}\n"
-
187  #else
-
188  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
-
189  #endif
-
190  #else
-
191  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
-
192  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg} {hfill} {func} @ {file}:{line}\n"
-
193  #else
-
194  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
-
195  #endif
-
196  #endif
-
197  #endif
-
198  #else
-
199  #ifndef CLUTCHLOG_DEFAULT_FORMAT
-
200  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
202  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg} {hfill} {func}\n"
-
203  #else
-
204  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func}\n"
-
205  #endif
-
206  #endif
-
207  #endif
-
208  static inline std::string default_format = CLUTCHLOG_DEFAULT_FORMAT;
-
210 
-
211  #ifndef NDEBUG
-
212  #ifndef CLUTCHDUMP_DEFAULT_FORMAT
-
213  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
215  #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}"
-
216  #else
-
217  #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}"
-
218  #endif
-
219  #endif // CLUTCHDUMP_DEFAULT_FORMAT
-
220  #else
-
221  #ifndef CLUTCHDUMP_DEFAULT_FORMAT
-
222  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
224  #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth})"
-
225  #else
-
226  #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func}"
-
227  #endif
-
228  #endif // CLUTCHDUMP_DEFAULT_FORMAT
-
229  #endif
-
230  static inline std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT;
-
232 
-
233  #ifndef CLUTCHDUMP_DEFAULT_SEP
-
234  #define CLUTCHDUMP_DEFAULT_SEP "\n"
-
236  #endif // CLUTCHDUMP_DEFAULT_SEP
-
237  static inline std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP;
-
239 
-
240  #ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK
-
241  #define CLUTCHLOG_DEFAULT_DEPTH_MARK ">"
-
243  #endif // CLUTCHLOG_DEFAULT_DEPTH_MARK
-
244  static inline std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK;
-
246 
-
247  #ifndef CLUTCHLOG_STRIP_CALLS
-
248  #define CLUTCHLOG_STRIP_CALLS 5
-
250  #endif // CLUTCHLOG_STRIP_CALLS
-
251  static inline unsigned int default_strip_calls = CLUTCHLOG_STRIP_CALLS;
-
253 
-
254  #ifndef CLUTCHLOG_HFILL_MARK
-
255  #define CLUTCHLOG_HFILL_MARK '.'
-
257  #endif // CLUTCHLOG_HFILL_MARK
-
258  static inline char default_hfill_char = CLUTCHLOG_HFILL_MARK;
-
260 
-
261 
-
262  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
-
263  #ifndef CLUTCHLOG_HFILL_MAX
-
264  #define CLUTCHLOG_HFILL_MAX 300
-
265  #endif
-
266  #endif
-
267  static inline unsigned short default_hfill_max = CLUTCHLOG_HFILL_MAX;
-
269 
-
270  // NOTE: there is no CLUTCHLOG_HFILL_STYLE for defaulting,
-
271  // but you can still set `hfill_style(...)` on the logger singleton.
-
272  /* @} */
+
169 #ifdef WITH_CLUTCHLOG
+
170 
+
177 class clutchlog
+
178 {
+
179  protected:
+
180 
+
185  #ifndef NDEBUG
+
186  #ifndef CLUTCHLOG_DEFAULT_FORMAT
+
187  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1 // Enables: name, depth and depth_marks
+
189  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1 // Enables: hfill
+
190  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg} {hfill} {func} @ {file}:{line}\n"
+
191  #else
+
192  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
+
193  #endif
+
194  #else
+
195  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
+
196  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg} {hfill} {func} @ {file}:{line}\n"
+
197  #else
+
198  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
+
199  #endif
+
200  #endif
+
201  #endif
+
202  #else
+
203  #ifndef CLUTCHLOG_DEFAULT_FORMAT
+
204  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
206  #define CLUTCHLOG_DEFAULT_FORMAT "[{name}] {level_letter}:{depth_marks} {msg} {hfill} {func}\n"
+
207  #else
+
208  #define CLUTCHLOG_DEFAULT_FORMAT "{level_letter} {msg}\t\t\t\t\t{func}\n"
+
209  #endif
+
210  #endif
+
211  #endif
+
212  static inline std::string default_format = CLUTCHLOG_DEFAULT_FORMAT;
+
214 
+
215  #ifndef NDEBUG
+
216  #ifndef CLUTCHDUMP_DEFAULT_FORMAT
+
217  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
219  #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth}) @ {file}:{line}"
+
220  #else
+
221  #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func} @ {file}:{line}"
+
222  #endif
+
223  #endif // CLUTCHDUMP_DEFAULT_FORMAT
+
224  #else
+
225  #ifndef CLUTCHDUMP_DEFAULT_FORMAT
+
226  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
228  #define CLUTCHDUMP_DEFAULT_FORMAT "# [{name}] {level} in {func} (at depth {depth})"
+
229  #else
+
230  #define CLUTCHDUMP_DEFAULT_FORMAT "# {level} in {func}"
+
231  #endif
+
232  #endif // CLUTCHDUMP_DEFAULT_FORMAT
+
233  #endif
+
234  static inline std::string dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT;
+
236 
+
237  #ifndef CLUTCHDUMP_DEFAULT_SEP
+
238  #define CLUTCHDUMP_DEFAULT_SEP "\n"
+
240  #endif // CLUTCHDUMP_DEFAULT_SEP
+
241  static inline std::string dump_default_sep = CLUTCHDUMP_DEFAULT_SEP;
+
243 
+
244  #ifndef CLUTCHLOG_DEFAULT_DEPTH_MARK
+
245  #define CLUTCHLOG_DEFAULT_DEPTH_MARK ">"
+
247  #endif // CLUTCHLOG_DEFAULT_DEPTH_MARK
+
248  static inline std::string default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK;
+
250 
+
251  #ifndef CLUTCHLOG_STRIP_CALLS
+
252  #define CLUTCHLOG_STRIP_CALLS 5
+
254  #endif // CLUTCHLOG_STRIP_CALLS
+
255  static inline unsigned int default_strip_calls = CLUTCHLOG_STRIP_CALLS;
+
257 
+
258  #ifndef CLUTCHLOG_HFILL_MARK
+
259  #define CLUTCHLOG_HFILL_MARK '.'
+
261  #endif // CLUTCHLOG_HFILL_MARK
+
262  static inline char default_hfill_char = CLUTCHLOG_HFILL_MARK;
+
264 
+
265 
+
266  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
+
267  #ifndef CLUTCHLOG_HFILL_MAX
+
268  #define CLUTCHLOG_HFILL_MAX 300
+
269  #endif
+
270  #endif
+
271  static inline size_t default_hfill_max = CLUTCHLOG_HFILL_MAX;
273 
-
274 
-
275  public:
-
276 
-
286  static clutchlog& logger()
-
287  {
-
288  static clutchlog instance;
-
289  return instance;
-
290  }
-
291 
-
293  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
-
294 
-
307  class fmt {
-
308  public:
-
310  enum class fg {
-
311  black = 30,
-
312  red = 31,
-
313  green = 32,
-
314  yellow = 33,
-
315  blue = 34,
-
316  magenta = 35,
-
317  cyan = 36,
-
318  white = 37,
-
319  none
-
320  } fore;
-
321 
-
323  enum class bg {
-
324  black = 40,
-
325  red = 41,
-
326  green = 42,
-
327  yellow = 43,
-
328  blue = 44,
-
329  magenta = 45,
-
330  cyan = 46,
-
331  white = 47,
-
332  none
-
333  } back;
-
334 
-
336  enum class typo {
-
337  reset = 0,
-
338  bold = 1,
-
339  underline = 4,
-
340  inverse = 7,
-
341  none
-
342  } style;
-
343 
-
345  fmt() : fore(fg::none), back(bg::none), style(typo::none) {}
-
346 
-
349  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
-
350  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) {}
-
351  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
-
352  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) {}
-
353  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) {}
-
354  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) {}
-
357  protected:
-
359  std::ostream& print_on( std::ostream& os) const
-
360  {
-
361  std::vector<int> codes; codes.reserve(3);
-
362  if(this->fore != fg::none) { codes.push_back(static_cast<int>(this->fore ));}
-
363  if(this->back != bg::none) { codes.push_back(static_cast<int>(this->back ));}
-
364  if(this->style != typo::none) { codes.push_back(static_cast<int>(this->style));}
-
365  if(codes.size() == 0) {return os;}
-
366 
-
367  os << "\033[";
-
368  assert(codes.size() > 0);
-
369  os << codes[0];
-
370  for(size_t i=1; i < codes.size(); ++i) {
-
371  os << ";" << codes[i];
-
372  }
-
373  os << "m";
-
374  return os;
-
375  }
-
376 
-
377  public:
-
389  friend std::ostream& operator<<(std::ostream& os, const fmt& fmt)
-
390  {
-
391  return fmt.print_on(os);
-
392  }
-
393 
-
404  std::string operator()( const std::string& msg ) const
-
405  {
-
406  std::ostringstream os;
-
407  this->print_on(os);
-
408  fmt reset(fmt::typo::reset);
-
409  os << msg;
-
410  reset.print_on(os);
-
411  return os.str();
-
412  }
-
413  }; // fmt class
-
414 
-
421  public:
-
422  clutchlog(clutchlog const&) = delete;
-
423  void operator=(clutchlog const&) = delete;
-
424 
-
425  private:
-
426  clutchlog() :
-
427  // system, main, log
-
428  _strip_calls(clutchlog::default_strip_calls),
-
429  _level_word({
-
430  {level::critical,"Critical"},
-
431  {level::error ,"Error"},
-
432  {level::warning ,"Warning"},
-
433  {level::progress,"Progress"},
-
434  {level::note ,"Note"},
-
435  {level::info ,"Info"},
-
436  {level::debug ,"Debug"},
-
437  {level::xdebug ,"XDebug"}
-
438  }),
-
439  _level_fmt({
-
440  {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
-
441  {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
-
442  {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
-
443  {level::progress,fmt()},
-
444  {level::note ,fmt()},
-
445  {level::info ,fmt()},
-
446  {level::debug ,fmt()},
-
447  {level::xdebug ,fmt()}
+
274  // NOTE: there is no CLUTCHLOG_HFILL_STYLE for defaulting,
+
275  // but you can still set `hfill_style(...)` on the logger singleton.
+
276  /* @} DefaultConfig */
+
277  /* @} */
+
278 
+
279 
+
280  public:
+
281 
+
291  static clutchlog& logger()
+
292  {
+
293  static clutchlog instance;
+
294  return instance;
+
295  }
+
296 
+
298  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
+
299 
+
309  class fmt {
+
310  public:
+
312  enum class fg {
+
313  black = 30,
+
314  red = 31,
+
315  green = 32,
+
316  yellow = 33,
+
317  blue = 34,
+
318  magenta = 35,
+
319  cyan = 36,
+
320  white = 37,
+
321  none
+
322  } fore;
+
323 
+
325  enum class bg {
+
326  black = 40,
+
327  red = 41,
+
328  green = 42,
+
329  yellow = 43,
+
330  blue = 44,
+
331  magenta = 45,
+
332  cyan = 46,
+
333  white = 47,
+
334  none
+
335  } back;
+
336 
+
338  enum class typo {
+
339  reset = 0,
+
340  bold = 1,
+
341  underline = 4,
+
342  inverse = 7,
+
343  none
+
344  } style;
+
345 
+
347  fmt() : fore(fg::none), back(bg::none), style(typo::none) {}
+
348 
+
351  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
+
352  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) {}
+
353  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
+
354  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) {}
+
355  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) {}
+
356  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) {}
+
359  protected:
+
361  std::ostream& print_on( std::ostream& os) const
+
362  {
+
363  std::vector<int> codes; codes.reserve(3);
+
364  if(this->fore != fg::none) { codes.push_back(static_cast<int>(this->fore ));}
+
365  if(this->back != bg::none) { codes.push_back(static_cast<int>(this->back ));}
+
366  if(this->style != typo::none) { codes.push_back(static_cast<int>(this->style));}
+
367  if(codes.size() == 0) {return os;}
+
368 
+
369  os << "\033[";
+
370  assert(codes.size() > 0);
+
371  os << codes[0];
+
372  for(size_t i=1; i < codes.size(); ++i) {
+
373  os << ";" << codes[i];
+
374  }
+
375  os << "m";
+
376  return os;
+
377  }
+
378 
+
379  public:
+
391  friend std::ostream& operator<<(std::ostream& os, const fmt& fmt)
+
392  {
+
393  return fmt.print_on(os);
+
394  }
+
395 
+
406  std::string operator()( const std::string& msg ) const
+
407  {
+
408  std::ostringstream os;
+
409  this->print_on(os);
+
410  fmt reset(fmt::typo::reset);
+
411  os << msg;
+
412  reset.print_on(os);
+
413  return os.str();
+
414  }
+
415 
+
418  std::string str() const
+
419  {
+
420  std::ostringstream os;
+
421  this->print_on(os);
+
422  return os.str();
+
423  }
+
424  }; // fmt class
+
425 
+
431  public:
+
432  clutchlog(clutchlog const&) = delete;
+
433  void operator=(clutchlog const&) = delete;
+
434 
+
435  private:
+
436  clutchlog() :
+
437  // system, main, log
+
438  _strip_calls(clutchlog::default_strip_calls),
+
439  _level_word({
+
440  {level::critical,"Critical"},
+
441  {level::error ,"Error"},
+
442  {level::warning ,"Warning"},
+
443  {level::progress,"Progress"},
+
444  {level::note ,"Note"},
+
445  {level::info ,"Info"},
+
446  {level::debug ,"Debug"},
+
447  {level::xdebug ,"XDebug"}
448  }),
-
449  _format_log(clutchlog::default_format),
-
450  _format_dump(clutchlog::dump_default_format),
-
451  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
-
452  _hfill_char(clutchlog::default_hfill_char),
-
453  _hfill_fmt(fmt::fg::none),
-
454  _hfill_max(clutchlog::default_hfill_max),
-
455  #endif
-
456  _out(&std::clog),
-
457  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
458  _depth(std::numeric_limits<size_t>::max() - _strip_calls),
-
459  _depth_mark(clutchlog::default_depth_mark),
-
460  #endif
-
461  _stage(level::error),
-
462  _in_file(".*"),
-
463  _in_func(".*"),
-
464  _in_line(".*")
-
465  {
-
466  // Reverse the level->word map into a word->level map.
-
467  for(auto& lw : _level_word) {
-
468  _word_level[lw.second] = lw.first;
-
469  }
-
470 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
-
471  struct winsize w;
-
472  ioctl(STDERR_FILENO, TIOCGWINSZ, &w);
-
473  _nb_columns = std::min(w.ws_col, default_hfill_max);
-
474 #endif
-
475  }
-
476 
-
477  protected:
-
479  size_t _strip_calls;
-
481  const std::map<level,std::string> _level_word;
-
483  std::map<std::string,level> _word_level;
-
485  std::map<level,fmt> _level_fmt;
-
487  std::string _format_log;
-
489  std::string _format_dump;
-
490  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
-
491 
-
492  char _hfill_char;
-
494  fmt _hfill_fmt;
-
496  unsigned short _hfill_max;
-
497  #endif
-
498 
-
499  std::ostream* _out;
-
500  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
449  _level_fmt({
+
450  {level::critical,fmt(fmt::fg::red, fmt::typo::underline)},
+
451  {level::error ,fmt(fmt::fg::red, fmt::typo::bold)},
+
452  {level::warning ,fmt(fmt::fg::magenta, fmt::typo::bold)},
+
453  {level::progress,fmt()},
+
454  {level::note ,fmt()},
+
455  {level::info ,fmt()},
+
456  {level::debug ,fmt()},
+
457  {level::xdebug ,fmt()}
+
458  }),
+
459  _format_log(clutchlog::default_format),
+
460  _format_dump(clutchlog::dump_default_format),
+
461  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
+
462  _hfill_char(clutchlog::default_hfill_char),
+
463  _hfill_fmt(fmt::fg::none),
+
464  _hfill_max(clutchlog::default_hfill_max),
+
465  #endif
+
466  _out(&std::clog),
+
467  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
468  _depth(std::numeric_limits<size_t>::max() - _strip_calls),
+
469  _depth_mark(clutchlog::default_depth_mark),
+
470  #endif
+
471  _stage(level::error),
+
472  _in_file(".*"),
+
473  _in_func(".*"),
+
474  _in_line(".*")
+
475  {
+
476  // Reverse the level->word map into a word->level map.
+
477  for(auto& lw : _level_word) {
+
478  _word_level[lw.second] = lw.first;
+
479  }
+
480 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
+
481  struct winsize w;
+
482  ioctl(STDERR_FILENO, TIOCGWINSZ, &w);
+
483  _nb_columns = std::min((size_t)w.ws_col, default_hfill_max);
+
484 #endif
+
485  }
+
486 
+
487  protected:
+
489  size_t _strip_calls;
+
491  const std::map<level,std::string> _level_word;
+
493  std::map<std::string,level> _word_level;
+
495  std::map<level,fmt> _level_fmt;
+
497  std::string _format_log;
+
499  std::string _format_dump;
+
500  #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
501 
-
502  size_t _depth;
-
504  std::string _depth_mark;
-
505  #endif
-
506 
-
507  level _stage;
-
509  std::regex _in_file;
-
511  std::regex _in_func;
-
513  std::regex _in_line;
-
514 
-
515 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
502  char _hfill_char;
+
504  fmt _hfill_fmt;
+
506  size_t _hfill_max;
+
507  #endif
+
508 
+
509  std::ostream* _out;
+
510  #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
511 
+
512  size_t _depth;
+
514  std::string _depth_mark;
+
515  #endif
516 
-
517  static const size_t _max_buffer = 4096;
-
518 #endif
-
519 
-
520 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
-
521 
-
522  size_t _nb_columns;
-
523 #endif
+
517  level _stage;
+
519  std::regex _in_file;
+
521  std::regex _in_func;
+
523  std::regex _in_line;
524 
-
526  public:
-
527 
-
531  void format(const std::string& format) {_format_log = format;}
-
534  std::string format() const {return _format_log;}
-
535 
-
537  void format_comment(const std::string& format) {_format_dump = format;}
-
539  std::string format_comment() const {return _format_dump;}
-
540 
-
542  void out(std::ostream& out) {_out = &out;}
-
544  std::ostream& out() {return *_out;}
+
525 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
526 
+
527  static const size_t _max_buffer = 4096;
+
528 #endif
+
529 
+
530 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
+
531 
+
532  size_t _nb_columns;
+
533 #endif
+
534 
+
536  public:
+
537 
+
541  void format(const std::string& format) {_format_log = format;}
+
544  std::string format() const {return _format_log;}
545 
-
546 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
547  void depth(size_t d) {_depth = d;}
-
550  size_t depth() const {return _depth;}
-
551 
-
553  void depth_mark(const std::string mark) {_depth_mark = mark;}
-
555  std::string depth_mark() const {return _depth_mark;}
-
556 
-
558  void strip_calls(const size_t n) {_strip_calls = n;}
-
560  size_t strip_calls() const {return _strip_calls;}
-
561 #endif
-
562 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
-
563  void hfill_mark(const char mark) {_hfill_char = mark;}
-
566  char hfill_mark() const {return _hfill_char;}
-
568  void hfill_style(fmt style) {_hfill_fmt = style;}
-
573  template<class ... FMT>
-
574  void style(FMT... styles) { this->hfill_style(fmt(styles...)); }
-
576  fmt hfill_style() const {return _hfill_fmt;}
-
578  void hfill_max(const size_t nmax) {_hfill_max = nmax;}
-
580  unsigned short hfill_max() {return _hfill_max;}
-
581 #endif
-
582 
-
584  void threshold(level l) {_stage = l;}
-
586  void threshold(const std::string& l) {_stage = this->level_of(l);}
-
588  level threshold() const {return _stage;}
-
590  const std::map<std::string,level>& levels() const { return _word_level;}
-
591 
-
596  level level_of(const std::string name)
-
597  {
-
598  const auto ilevel = _word_level.find(name);
-
599  if( ilevel != std::end(_word_level)) {
-
600  return ilevel->second;
-
601  } else {
-
602  throw std::out_of_range("'" + name + "' is not a valid log level name");
-
603  }
-
604  }
-
605 
-
607  void file(std::string file) {_in_file = file;}
-
609  void func(std::string func) {_in_func = func;}
-
611  void line(std::string line) {_in_line = line;}
-
612 
-
614  void location(
-
615  const std::string& in_file,
-
616  const std::string& in_function=".*",
-
617  const std::string& in_line=".*"
-
618  )
-
619  {
-
620  file(in_file);
-
621  func(in_function);
-
622  line(in_line);
-
623  }
-
624 
-
629  template<class ... FMT>
-
630  void style(level stage, FMT... styles) { this->style(stage,fmt(styles...)); }
-
632  void style(level stage, fmt style) { _level_fmt.at(stage) = style; }
-
634  fmt style(level stage) const { return _level_fmt.at(stage); }
-
635 
-
638  public:
-
639 
-
643  struct scope_t {
-
646  bool matches;
-
648  level stage;
-
649 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
650 
-
651  size_t depth;
-
652 #endif
-
653 
-
654  bool there;
-
656  scope_t() :
-
657  matches(false),
-
658  stage(level::xdebug),
-
659 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
660  depth(0),
-
661 #endif
-
662  there(false)
-
663  {}
-
664  }; // scope_t
-
665 
-
666 
-
668  scope_t locate(
-
669  const level& stage,
-
670  const std::string& file,
-
671  const std::string& func,
-
672  const size_t line
-
673  ) const
-
674  {
-
675  scope_t scope; // False scope by default.
+
547  void format_comment(const std::string& format) {_format_dump = format;}
+
549  std::string format_comment() const {return _format_dump;}
+
550 
+
552  void out(std::ostream& out) {_out = &out;}
+
554  std::ostream& out() {return *_out;}
+
555 
+
556 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
557  void depth(size_t d) {_depth = d;}
+
560  size_t depth() const {return _depth;}
+
561 
+
563  void depth_mark(const std::string mark) {_depth_mark = mark;}
+
565  std::string depth_mark() const {return _depth_mark;}
+
566 
+
568  void strip_calls(const size_t n) {_strip_calls = n;}
+
570  size_t strip_calls() const {return _strip_calls;}
+
571 #endif
+
572 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
+
573  void hfill_mark(const char mark) {_hfill_char = mark;}
+
576  char hfill_mark() const {return _hfill_char;}
+
578  void hfill_style(fmt style) {_hfill_fmt = style;}
+
583  template<class ... FMT>
+
584  void hfill_style(FMT... styles) { this->hfill_style(fmt(styles...)); }
+
586  fmt hfill_style() const {return _hfill_fmt;}
+
588  void hfill_max(const size_t nmax) {_hfill_max = nmax;}
+
590  size_t hfill_max() {return _hfill_max;}
+
591 #endif
+
592 
+
594  void threshold(level l) {_stage = l;}
+
596  void threshold(const std::string& l) {_stage = this->level_of(l);}
+
598  level threshold() const {return _stage;}
+
600  const std::map<std::string,level>& levels() const { return _word_level;}
+
601 
+
606  level level_of(const std::string name)
+
607  {
+
608  const auto ilevel = _word_level.find(name);
+
609  if( ilevel != std::end(_word_level)) {
+
610  return ilevel->second;
+
611  } else {
+
612  throw std::out_of_range("'" + name + "' is not a valid log level name");
+
613  }
+
614  }
+
615 
+
617  void file(std::string file) {_in_file = file;}
+
619  void func(std::string func) {_in_func = func;}
+
621  void line(std::string line) {_in_line = line;}
+
622 
+
624  void location(
+
625  const std::string& in_file,
+
626  const std::string& in_function=".*",
+
627  const std::string& in_line=".*"
+
628  )
+
629  {
+
630  file(in_file);
+
631  func(in_function);
+
632  line(in_line);
+
633  }
+
634 
+
639  template<class ... FMT>
+
640  void style(level stage, FMT... styles) { this->style(stage,fmt(styles...)); }
+
642  void style(level stage, fmt style) { _level_fmt.at(stage) = style; }
+
644  fmt style(level stage) const { return _level_fmt.at(stage); }
+
645 
+
648  public:
+
649 
+
653  struct scope_t {
+
656  bool matches;
+
658  level stage;
+
659 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
660 
+
661  size_t depth;
+
662 #endif
+
663 
+
664  bool there;
+
666  scope_t() :
+
667  matches(false),
+
668  stage(level::xdebug),
+
669 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
670  depth(0),
+
671 #endif
+
672  there(false)
+
673  {}
+
674  }; // scope_t
+
675 
676 
-
677  /***** Log level stage *****/
-
678  // Test stage first, because it's fastest.
-
679  scope.stage = stage;
-
680  if(not (scope.stage <= _stage)) {
-
681  // Bypass useless computations if no match
-
682  // because of the stage.
-
683  return scope;
-
684  }
-
685 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
686  /***** Stack depth *****/
-
687  // Backtrace in second, quite fast.
-
688  size_t stack_depth;
-
689  void *buffer[_max_buffer];
-
690  stack_depth = backtrace(buffer, _max_buffer);
-
691  scope.depth = stack_depth;
-
692  if(not (scope.depth <= _depth + _strip_calls)) {
-
693  // Bypass if no match.
-
694  return scope;
-
695  }
-
696 #endif
-
697 
-
698  /***** Location *****/
-
699  // Location last, slowest.
-
700  std::ostringstream sline; sline << line;
-
701  scope.there =
-
702  std::regex_search(file, _in_file)
-
703  and std::regex_search(func, _in_func)
-
704  and std::regex_search(sline.str(), _in_line);
-
705 
-
706  // No need to retest stage and depth, which are true here.
-
707  scope.matches = scope.there;
-
708 
-
709  return scope;
-
710  } // locate
-
711 
-
719  std::string replace(
-
720  const std::string& form,
-
721  const std::string& mark,
-
722  const std::string& tag
-
723  ) const
-
724  {
-
725  // Useless debug code, unless something fancy would be done with name tags.
-
726  // std::regex re;
-
727  // try {
-
728  // re = std::regex(mark);
-
729  //
-
730  // } catch(const std::regex_error& e) {
-
731  // std::cerr << "ERROR with a regular expression \"" << mark << "\": ";
-
732  // switch(e.code()) {
-
733  // case std::regex_constants::error_collate:
-
734  // std::cerr << "the expression contains an invalid collating element name";
-
735  // break;
-
736  // case std::regex_constants::error_ctype:
-
737  // std::cerr << "the expression contains an invalid character class name";
-
738  // break;
-
739  // case std::regex_constants::error_escape:
-
740  // std::cerr << "the expression contains an invalid escaped character or a trailing escape";
-
741  // break;
-
742  // case std::regex_constants::error_backref:
-
743  // std::cerr << "the expression contains an invalid back reference";
-
744  // break;
-
745  // case std::regex_constants::error_brack:
-
746  // std::cerr << "the expression contains mismatched square brackets ('[' and ']')";
-
747  // break;
-
748  // case std::regex_constants::error_paren:
-
749  // std::cerr << "the expression contains mismatched parentheses ('(' and ')')";
-
750  // break;
-
751  // case std::regex_constants::error_brace:
-
752  // std::cerr << "the expression contains mismatched curly braces ('{' and '}')";
-
753  // break;
-
754  // case std::regex_constants::error_badbrace:
-
755  // std::cerr << "the expression contains an invalid range in a {} expression";
-
756  // break;
-
757  // case std::regex_constants::error_range:
-
758  // std::cerr << "the expression contains an invalid character range (e.g. [b-a])";
-
759  // break;
-
760  // case std::regex_constants::error_space:
-
761  // std::cerr << "there was not enough memory to convert the expression into a finite state machine";
-
762  // break;
-
763  // case std::regex_constants::error_badrepeat:
-
764  // std::cerr << "one of *?+{ was not preceded by a valid regular expression";
-
765  // break;
-
766  // case std::regex_constants::error_complexity:
-
767  // std::cerr << "the complexity of an attempted match exceeded a predefined level";
-
768  // break;
-
769  // case std::regex_constants::error_stack:
-
770  // std::cerr << "there was not enough memory to perform a match";
-
771  // break;
-
772  // default:
-
773  // std::cerr << "unknown error";
-
774  // }
-
775  // std::cerr << std::endl;
-
776  // throw;
-
777  // } // catch
-
778 
-
779  const std::regex re(mark);
-
780  return std::regex_replace(form, re, tag);
-
781  }
-
782 
-
784  std::string replace(
-
785  const std::string& form,
-
786  const std::string& mark,
-
787  const size_t tag
-
788  ) const
-
789  {
-
790  std::ostringstream stag; stag << tag;
-
791  return replace(form, mark, stag.str());
-
792  }
-
793 
-
795  std::string format(
-
796  std::string format,
-
797  const std::string& what,
-
798 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
799  const std::string& name,
-
800 #endif
-
801  const level& stage,
-
802  const std::string& file,
-
803  const std::string& func,
-
804  const size_t line
-
805 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
806  ,
-
807  const size_t depth
-
808 #endif
-
809  ) const
-
810  {
-
811  format = replace(format, "\\{msg\\}", what);
-
812  format = replace(format, "\\{file\\}", file);
-
813  format = replace(format, "\\{func\\}", func);
-
814  format = replace(format, "\\{line\\}", line);
-
815 
-
816  format = replace(format, "\\{level\\}", _level_word.at(stage));
-
817  std::string letter(1, _level_word.at(stage).at(0)); // char -> string
-
818  format = replace(format, "\\{level_letter\\}", letter);
-
819 
-
820 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
821  format = replace(format, "\\{name\\}", name);
-
822  format = replace(format, "\\{depth\\}", depth - _strip_calls);
-
823 
-
824  std::ostringstream chevrons;
-
825  for(size_t i = _strip_calls; i < depth; ++i) {
-
826  chevrons << _depth_mark;
-
827  }
-
828  format = replace(format, "\\{depth_marks\\}", chevrons.str());
-
829 #endif
-
830 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
-
831  const std::string hfill_tag = "{hfill}";
-
832  const size_t hfill_pos = format.find(hfill_tag);
-
833  if(hfill_pos != std::string::npos) {
-
834  if(_nb_columns > 0) {
-
835  const size_t left_len = hfill_pos;
-
836  const size_t right_len = format.size() - hfill_pos - hfill_tag.size();
-
837  if(right_len+left_len > _nb_columns) {
-
838  // The right part would go over the terminal width: add a new line.
-
839  const std::string hfill(std::max((size_t)0, _nb_columns-right_len), _hfill_char);
-
840  const std::string hfill_styled = _hfill_fmt(hfill);
-
841  format = replace(format, "\\{hfill\\}", "\n"+hfill_styled);
-
842  } else {
-
843  // There is some space in between left and right parts.
-
844  const std::string hfill(std::max((size_t)0, _nb_columns - (right_len+left_len)), _hfill_char);
-
845  const std::string hfill_styled = _hfill_fmt(hfill);
-
846  format = replace(format, "\\{hfill\\}", hfill_styled);
-
847  }
-
848  } else {
-
849  // We don't know the terminal width.
-
850  const std::string hfill(1, _hfill_char);
-
851  const std::string hfill_styled = _hfill_fmt(hfill);
-
852  format = replace(format, "\\{hfill\\}", hfill_styled);
-
853  }
-
854  }
-
855 #endif
-
856  return _level_fmt.at(stage)(format);
-
857  }
-
858 
-
860  void log(
-
861  const level& stage,
-
862  const std::string& what,
-
863  const std::string& file, const std::string& func, size_t line
-
864  ) const
-
865  {
-
866  scope_t scope = locate(stage, file, func, line);
-
867 
-
868  if(scope.matches) {
-
869 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
870  *_out << format(_format_log, what, basename(getenv("_")),
-
871  stage, file, func,
-
872  line, scope.depth );
+
678  scope_t locate(
+
679  const level& stage,
+
680  const std::string& file,
+
681  const std::string& func,
+
682  const size_t line
+
683  ) const
+
684  {
+
685  scope_t scope; // False scope by default.
+
686 
+
687  /***** Log level stage *****/
+
688  // Test stage first, because it's fastest.
+
689  scope.stage = stage;
+
690  if(not (scope.stage <= _stage)) {
+
691  // Bypass useless computations if no match
+
692  // because of the stage.
+
693  return scope;
+
694  }
+
695 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
696  /***** Stack depth *****/
+
697  // Backtrace in second, quite fast.
+
698  size_t stack_depth;
+
699  void *buffer[_max_buffer];
+
700  stack_depth = backtrace(buffer, _max_buffer);
+
701  scope.depth = stack_depth;
+
702  if(not (scope.depth <= _depth + _strip_calls)) {
+
703  // Bypass if no match.
+
704  return scope;
+
705  }
+
706 #endif
+
707 
+
708  /***** Location *****/
+
709  // Location last, slowest.
+
710  std::ostringstream sline; sline << line;
+
711  scope.there =
+
712  std::regex_search(file, _in_file)
+
713  and std::regex_search(func, _in_func)
+
714  and std::regex_search(sline.str(), _in_line);
+
715 
+
716  // No need to retest stage and depth, which are true here.
+
717  scope.matches = scope.there;
+
718 
+
719  return scope;
+
720  } // locate
+
721 
+
729  std::string replace(
+
730  const std::string& form,
+
731  const std::string& mark,
+
732  const std::string& tag
+
733  ) const
+
734  {
+
735  // Useless debug code, unless something fancy would be done with name tags.
+
736  // std::regex re;
+
737  // try {
+
738  // re = std::regex(mark);
+
739  //
+
740  // } catch(const std::regex_error& e) {
+
741  // std::cerr << "ERROR with a regular expression \"" << mark << "\": ";
+
742  // switch(e.code()) {
+
743  // case std::regex_constants::error_collate:
+
744  // std::cerr << "the expression contains an invalid collating element name";
+
745  // break;
+
746  // case std::regex_constants::error_ctype:
+
747  // std::cerr << "the expression contains an invalid character class name";
+
748  // break;
+
749  // case std::regex_constants::error_escape:
+
750  // std::cerr << "the expression contains an invalid escaped character or a trailing escape";
+
751  // break;
+
752  // case std::regex_constants::error_backref:
+
753  // std::cerr << "the expression contains an invalid back reference";
+
754  // break;
+
755  // case std::regex_constants::error_brack:
+
756  // std::cerr << "the expression contains mismatched square brackets ('[' and ']')";
+
757  // break;
+
758  // case std::regex_constants::error_paren:
+
759  // std::cerr << "the expression contains mismatched parentheses ('(' and ')')";
+
760  // break;
+
761  // case std::regex_constants::error_brace:
+
762  // std::cerr << "the expression contains mismatched curly braces ('{' and '}')";
+
763  // break;
+
764  // case std::regex_constants::error_badbrace:
+
765  // std::cerr << "the expression contains an invalid range in a {} expression";
+
766  // break;
+
767  // case std::regex_constants::error_range:
+
768  // std::cerr << "the expression contains an invalid character range (e.g. [b-a])";
+
769  // break;
+
770  // case std::regex_constants::error_space:
+
771  // std::cerr << "there was not enough memory to convert the expression into a finite state machine";
+
772  // break;
+
773  // case std::regex_constants::error_badrepeat:
+
774  // std::cerr << "one of *?+{ was not preceded by a valid regular expression";
+
775  // break;
+
776  // case std::regex_constants::error_complexity:
+
777  // std::cerr << "the complexity of an attempted match exceeded a predefined level";
+
778  // break;
+
779  // case std::regex_constants::error_stack:
+
780  // std::cerr << "there was not enough memory to perform a match";
+
781  // break;
+
782  // default:
+
783  // std::cerr << "unknown error";
+
784  // }
+
785  // std::cerr << std::endl;
+
786  // throw;
+
787  // } // catch
+
788 
+
789  const std::regex re(mark);
+
790  return std::regex_replace(form, re, tag);
+
791  }
+
792 
+
794  std::string replace(
+
795  const std::string& form,
+
796  const std::string& mark,
+
797  const size_t tag
+
798  ) const
+
799  {
+
800  std::ostringstream stag; stag << tag;
+
801  return replace(form, mark, stag.str());
+
802  }
+
803 
+
805  std::string format(
+
806  std::string row,
+
807  const std::string& what,
+
808 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
809  const std::string& name,
+
810 #endif
+
811  const level& stage,
+
812  const std::string& file,
+
813  const std::string& func,
+
814  const size_t line
+
815 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
816  ,
+
817  const size_t depth
+
818 #endif
+
819  ) const
+
820  {
+
821  row = replace(row, "\\{msg\\}", what);
+
822  row = replace(row, "\\{file\\}", file);
+
823  row = replace(row, "\\{func\\}", func);
+
824  row = replace(row, "\\{line\\}", line);
+
825 
+
826  row = replace(row, "\\{level\\}", _level_word.at(stage));
+
827  std::string letter(1, _level_word.at(stage).at(0)); // char -> string
+
828  row = replace(row, "\\{level_letter\\}", letter);
+
829 
+
830 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
831  row = replace(row, "\\{name\\}", name);
+
832  row = replace(row, "\\{depth\\}", depth - _strip_calls);
+
833 
+
834  std::ostringstream chevrons;
+
835  for(size_t i = _strip_calls; i < depth; ++i) {
+
836  chevrons << _depth_mark;
+
837  }
+
838  row = replace(row, "\\{depth_marks\\}", chevrons.str());
+
839 #endif
+
840 
+
841  row = replace(row, "\\{level_fmt\\}", _level_fmt.at(stage).str());
+
842 
+
843 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL
+
844  // hfill is replaced last to allow for correct line width estimation.
+
845  const std::string raw_row = replace(row, "\\x1B\\[([0-9]{1,2}(;[0-9]{1,2})?)?[m|K]", "");
+
846  const std::string hfill_tag = "{hfill}";
+
847  const size_t hfill_pos = row.find(hfill_tag);
+
848  const size_t raw_hfill_pos = raw_row.find(hfill_tag);
+
849  const size_t nb_columns = std::min(_nb_columns, _hfill_max);
+
850  if(hfill_pos != std::string::npos) {
+
851  assert(raw_hfill_pos != std::string::npos);
+
852  if(nb_columns > 0) {
+
853  const size_t left_len = raw_hfill_pos;
+
854  const size_t right_len = raw_row.size() - raw_hfill_pos - hfill_tag.size();
+
855  if(right_len+left_len > nb_columns) {
+
856  // The right part would go over the terminal width: add a new row.
+
857  const std::string hfill(std::max((size_t)0, nb_columns-right_len), _hfill_char);
+
858  const std::string hfill_styled = _hfill_fmt(hfill);
+
859  row = replace(row, "\\{hfill\\}", "\n"+hfill_styled);
+
860  } else {
+
861  // There is some space in between left and right parts.
+
862  const std::string hfill(std::max((size_t)0, nb_columns - (right_len+left_len)), _hfill_char);
+
863  const std::string hfill_styled = _hfill_fmt(hfill);
+
864  row = replace(row, "\\{hfill\\}", hfill_styled);
+
865  }
+
866  } else {
+
867  // We don't know the terminal width.
+
868  const std::string hfill(1, _hfill_char);
+
869  const std::string hfill_styled = _hfill_fmt(hfill);
+
870  row = replace(row, "\\{hfill\\}", hfill_styled);
+
871  }
+
872  }
873 #else
-
874  *_out << format(_format_log, what,
-
875  stage, file, func,
-
876  line );
-
877 
+
874  // We cannot know the terminal width.
+
875  const std::string hfill(1, _hfill_char);
+
876  const std::string hfill_styled = _hfill_fmt(hfill);
+
877  row = replace(row, "\\{hfill\\}", hfill_styled);
878 #endif
-
879  _out->flush();
-
880  } // if scopes.matches
-
881  }
-
882 
-
884  template<class In>
-
885  void dump(
-
886  const level& stage,
-
887  const In container_begin, const In container_end,
-
888  const std::string& file, const std::string& func, size_t line,
-
889  const std::string& filename_template = "dump_{n}.dat",
-
890  const std::string sep = dump_default_sep
-
891  ) const
-
892  {
-
893  scope_t scope = locate(stage, file, func, line);
-
894 
-
895  if(scope.matches) {
-
896  const std::string tag = "\\{n\\}";
-
897  const std::regex re(tag);
-
898  std::string outfile = "";
-
899 
-
900  // If the file name template has the {n} tag.
-
901  if(std::regex_search(filename_template, re)) {
-
902  // Increment n until a free one is found.
-
903  size_t n = 0;
-
904  do {
-
905  outfile = replace(filename_template, tag, n);
-
906  n++;
-
907  } while( fs::exists( outfile ) );
-
908 
-
909  } else {
-
910  // Use the parameter as is.
-
911  outfile = filename_template;
-
912  }
-
913 
-
914  std::ofstream fd(outfile);
-
915 
-
916  if(_format_dump.size() > 0) {
-
917 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
918  fd << format(_format_dump, "", basename(getenv("_")),
-
919  stage, file, func,
-
920  line, scope.depth );
-
921 #else
-
922  fd << format(_format_dump, "",
-
923  stage, file, func,
-
924  line );
-
925 #endif
-
926  fd << sep; // sep after comment line.
-
927  }
-
928 
-
929  std::copy(container_begin, container_end,
-
930  std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
+
879  return _level_fmt.at(stage)(row);
+
880  }
+
881 
+
883  void log(
+
884  const level& stage,
+
885  const std::string& what,
+
886  const std::string& file, const std::string& func, size_t line
+
887  ) const
+
888  {
+
889  scope_t scope = locate(stage, file, func, line);
+
890 
+
891  if(scope.matches) {
+
892 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
893  *_out << format(_format_log, what, basename(getenv("_")),
+
894  stage, file, func,
+
895  line, scope.depth );
+
896 #else
+
897  *_out << format(_format_log, what,
+
898  stage, file, func,
+
899  line );
+
900 
+
901 #endif
+
902  _out->flush();
+
903  } // if scopes.matches
+
904  }
+
905 
+
907  template<class In>
+
908  void dump(
+
909  const level& stage,
+
910  const In container_begin, const In container_end,
+
911  const std::string& file, const std::string& func, size_t line,
+
912  const std::string& filename_template = "dump_{n}.dat",
+
913  const std::string sep = dump_default_sep
+
914  ) const
+
915  {
+
916  scope_t scope = locate(stage, file, func, line);
+
917 
+
918  if(scope.matches) {
+
919  const std::string tag = "\\{n\\}";
+
920  const std::regex re(tag);
+
921  std::string outfile = "";
+
922 
+
923  // If the file name template has the {n} tag.
+
924  if(std::regex_search(filename_template, re)) {
+
925  // Increment n until a free one is found.
+
926  size_t n = 0;
+
927  do {
+
928  outfile = replace(filename_template, tag, n);
+
929  n++;
+
930  } while( fs::exists( outfile ) );
931 
-
932  fd.close();
-
933  } // if scopes.matches
-
934  }
-
935 
-
937 };
+
932  } else {
+
933  // Use the parameter as is.
+
934  outfile = filename_template;
+
935  }
+
936 
+
937  std::ofstream fd(outfile);
938 
-
941 #else // not WITH_CLUTCHLOG
-
942 
-
943 
-
944 /**********************************************************************
-
945  * Fake implementation
-
946  **********************************************************************/
-
947 
-
948 // Equivalent class with empty methods, will be optimized out
-
949 // while allowing to actually have calls implemented without WITH_CLUTCHLOG guards.
-
950 #pragma GCC diagnostic push
-
951 #pragma GCC diagnostic ignored "-Wreturn-type"
-
952 class clutchlog
-
953 {
-
954  public:
-
955  static clutchlog& logger() {}
-
956  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
-
957  class fmt {
-
958  public:
-
959  enum class fg { black, red, green, yellow, blue, magenta, cyan, white, none } fore;
-
960  enum class bg { black, red, green, yellow, blue, magenta, cyan, white, none } back;
-
961  enum class typo { reset, bold, underline, inverse, none } style;
-
962  fmt() : fore(fg::none), back(bg::none), style(typo::none) {}
-
963  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
-
964  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) {}
-
965  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
-
966  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) {}
-
967  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) {}
-
968  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) {}
-
969  protected:
-
970  std::ostream& print_on(std::ostream&) const {}
-
971  public:
-
972  friend std::ostream& operator<<(std::ostream&, const fmt&) {}
-
973  std::string operator()(const std::string&) const {}
-
974  };
-
975  public:
-
976  clutchlog(clutchlog const&) = delete;
-
977  void operator=(clutchlog const&) = delete;
-
978  private:
-
979  clutchlog() {}
-
980  protected:
-
981  struct scope_t {};
-
982  scope_t locate(
-
983  const level&,
-
984  const std::string&,
-
985  const std::string&,
-
986  const size_t
-
987  ) const
-
988  {}
-
989  public:
-
990  void format(const std::string&) {}
-
991  std::string format() const {}
-
992 
-
993  void format_comment(const std::string&) {}
-
994  std::string format_comment() const {}
-
995 
-
996  void out(std::ostream&) {}
-
997  std::ostream& out() {}
-
998 
-
999 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
1000  void depth(size_t) {}
-
1001  size_t depth() const {}
-
1002 
-
1003  void depth_mark(const std::string) {}
-
1004  std::string depth_mark() const {}
-
1005  void strip_calls(const size_t) {}
-
1006  size_t strip_calls() const {}
-
1007 #endif
-
1008 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
-
1009  void hfill_mark(const char) {}
-
1010  char hfill_mark() const {}
-
1011  void hfill_fmt(fmt) {}
-
1012  fmt hfill_fmt() const {}
-
1013  void hfill_max(const size_t) {}
-
1014  unsigned short hfill_max() {}
-
1015 #endif
-
1016 
-
1017  void threshold(level) {}
-
1018  void threshold(const std::string&) {}
-
1019  level threshold() const {}
-
1020  const std::map<std::string,level> levels() const {}
-
1021  level level_of(const std::string) {}
-
1022 
-
1023  void file(std::string) {}
-
1024  void func(std::string) {}
-
1025  void line(std::string) {}
-
1026 
-
1027 #pragma GCC diagnostic push
-
1028 #pragma GCC diagnostic ignored "-Wunused-parameter"
-
1029  void location(
-
1030  const std::string&,
-
1031  const std::string& in_function=".*",
-
1032  const std::string& in_line=".*"
-
1033  )
-
1034  {}
-
1035 #pragma GCC diagnostic pop
-
1036  template<class ... FMT>
-
1037  void style(level, FMT...) {}
-
1038  void style(level, fmt) {}
-
1039  fmt style(level) const {}
-
1040  public:
-
1041  std::string replace(
-
1042  const std::string&,
-
1043  const std::string&,
-
1044  const std::string&
-
1045  ) const
-
1046  {}
-
1047 
-
1048  std::string replace(
-
1049  const std::string&,
-
1050  const std::string&,
-
1051  const size_t
-
1052  ) const
-
1053  {}
-
1054 
-
1055  std::string format(
-
1056  std::string,
-
1057  const std::string&,
-
1058 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
1059  const std::string&,
-
1060 #endif
-
1061  const level&,
-
1062  const std::string&,
-
1063  const std::string&,
-
1064  const size_t
-
1065 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
-
1066  ,
-
1067  const size_t
-
1068 #endif
-
1069  ) const
-
1070  {}
-
1071 
-
1072  void log(
-
1073  const level&,
-
1074  const std::string&,
-
1075  const std::string&, const std::string&, size_t
-
1076  ) const
-
1077  {}
-
1078 
-
1079  template<class In>
-
1080  void dump(
-
1081  const level&,
-
1082  const In, const In,
-
1083  const std::string&, const std::string&, size_t,
-
1084  const std::string&,
-
1085  const std::string
-
1086  ) const
-
1087  {}
-
1088 };
-
1089 #pragma GCC diagnostic pop
-
1090 #endif // WITH_CLUTCHLOG
-
1091 
-
1092 #endif // CLUTCHLOG_H
+
939  if(_format_dump.size() > 0) {
+
940 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
941  fd << format(_format_dump, "", basename(getenv("_")),
+
942  stage, file, func,
+
943  line, scope.depth );
+
944 #else
+
945  fd << format(_format_dump, "",
+
946  stage, file, func,
+
947  line );
+
948 #endif
+
949  fd << sep; // sep after comment line.
+
950  }
+
951 
+
952  std::copy(container_begin, container_end,
+
953  std::ostream_iterator<typename In::value_type>(fd, sep.c_str()));
+
954 
+
955  fd.close();
+
956  } // if scopes.matches
+
957  }
+
958 
+
960 };
+
961 
+
964 #else // not WITH_CLUTCHLOG
+
965 
+
966 
+
967 /**********************************************************************
+
968  * Fake implementation
+
969  **********************************************************************/
+
970 
+
971 // Equivalent class with empty methods, will be optimized out
+
972 // while allowing to actually have calls implemented without WITH_CLUTCHLOG guards.
+
973 #pragma GCC diagnostic push
+
974 #pragma GCC diagnostic ignored "-Wreturn-type"
+
975 class clutchlog
+
976 {
+
977  public:
+
978  static clutchlog& logger() {}
+
979  enum level {critical=0, error=1, warning=2, progress=3, note=4, info=5, debug=6, xdebug=7};
+
980  class fmt {
+
981  public:
+
982  enum class fg { black, red, green, yellow, blue, magenta, cyan, white, none } fore;
+
983  enum class bg { black, red, green, yellow, blue, magenta, cyan, white, none } back;
+
984  enum class typo { reset, bold, underline, inverse, none } style;
+
985  fmt() : fore(fg::none), back(bg::none), style(typo::none) {}
+
986  fmt( fg f, bg b = bg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
+
987  fmt( fg f, typo s , bg b = bg::none) : fore(f), back(b), style(s) {}
+
988  fmt( bg b, fg f = fg::none, typo s = typo::none) : fore(f), back(b), style(s) {}
+
989  fmt( bg b, typo s , fg f = fg::none) : fore(f), back(b), style(s) {}
+
990  fmt(typo s, fg f = fg::none, bg b = bg::none) : fore(f), back(b), style(s) {}
+
991  fmt(typo s, bg b , fg f = fg::none) : fore(f), back(b), style(s) {}
+
992  protected:
+
993  std::ostream& print_on(std::ostream&) const {}
+
994  public:
+
995  friend std::ostream& operator<<(std::ostream&, const fmt&) {}
+
996  std::string operator()(const std::string&) const {}
+
997  };
+
998  public:
+
999  clutchlog(clutchlog const&) = delete;
+
1000  void operator=(clutchlog const&) = delete;
+
1001  private:
+
1002  clutchlog() {}
+
1003  protected:
+
1004  struct scope_t {};
+
1005  scope_t locate(
+
1006  const level&,
+
1007  const std::string&,
+
1008  const std::string&,
+
1009  const size_t
+
1010  ) const
+
1011  {}
+
1012  public:
+
1013  void format(const std::string&) {}
+
1014  std::string format() const {}
+
1015 
+
1016  void format_comment(const std::string&) {}
+
1017  std::string format_comment() const {}
+
1018 
+
1019  void out(std::ostream&) {}
+
1020  std::ostream& out() {}
+
1021 
+
1022 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
1023  void depth(size_t) {}
+
1024  size_t depth() const {}
+
1025 
+
1026  void depth_mark(const std::string) {}
+
1027  std::string depth_mark() const {}
+
1028  void strip_calls(const size_t) {}
+
1029  size_t strip_calls() const {}
+
1030 #endif
+
1031 #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
+
1032  void hfill_mark(const char) {}
+
1033  char hfill_mark() const {}
+
1034  void hfill_fmt(fmt) {}
+
1035  fmt hfill_fmt() const {}
+
1036  void hfill_max(const size_t) {}
+
1037  size_t hfill_max() {}
+
1038 #endif
+
1039 
+
1040  void threshold(level) {}
+
1041  void threshold(const std::string&) {}
+
1042  level threshold() const {}
+
1043  const std::map<std::string,level> levels() const {}
+
1044  level level_of(const std::string) {}
+
1045 
+
1046  void file(std::string) {}
+
1047  void func(std::string) {}
+
1048  void line(std::string) {}
+
1049 
+
1050 #pragma GCC diagnostic push
+
1051 #pragma GCC diagnostic ignored "-Wunused-parameter"
+
1052  void location(
+
1053  const std::string&,
+
1054  const std::string& in_function=".*",
+
1055  const std::string& in_line=".*"
+
1056  )
+
1057  {}
+
1058 #pragma GCC diagnostic pop
+
1059  template<class ... FMT>
+
1060  void style(level, FMT...) {}
+
1061  void style(level, fmt) {}
+
1062  fmt style(level) const {}
+
1063  public:
+
1064  std::string replace(
+
1065  const std::string&,
+
1066  const std::string&,
+
1067  const std::string&
+
1068  ) const
+
1069  {}
+
1070 
+
1071  std::string replace(
+
1072  const std::string&,
+
1073  const std::string&,
+
1074  const size_t
+
1075  ) const
+
1076  {}
+
1077 
+
1078  std::string format(
+
1079  std::string,
+
1080  const std::string&,
+
1081 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
1082  const std::string&,
+
1083 #endif
+
1084  const level&,
+
1085  const std::string&,
+
1086  const std::string&,
+
1087  const size_t
+
1088 #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
+
1089  ,
+
1090  const size_t
+
1091 #endif
+
1092  ) const
+
1093  {}
+
1094 
+
1095  void log(
+
1096  const level&,
+
1097  const std::string&,
+
1098  const std::string&, const std::string&, size_t
+
1099  ) const
+
1100  {}
+
1101 
+
1102  template<class In>
+
1103  void dump(
+
1104  const level&,
+
1105  const In, const In,
+
1106  const std::string&, const std::string&, size_t,
+
1107  const std::string&,
+
1108  const std::string
+
1109  ) const
+
1110  {}
+
1111 };
+
1112 #pragma GCC diagnostic pop
+
1113 #endif // WITH_CLUTCHLOG
+
1114 
+
1115 #endif // CLUTCHLOG_H
-
clutchlog::file
void file(std::string file)
Set the regular expression filtering the file location.
Definition: clutchlog.h:607
-
CLUTCHDUMP_DEFAULT_FORMAT
#define CLUTCHDUMP_DEFAULT_FORMAT
Compile-time default format of the comment line in file dump.
Definition: clutchlog.h:217
-
clutchlog::fmt::fg
fg
Foreground color codes.
Definition: clutchlog.h:310
-
clutchlog::dump_default_format
static std::string dump_default_format
Default format of the comment line in file dump.
Definition: clutchlog.h:231
-
clutchlog::levels
const std::map< std::string, level > & levels() const
Get the map of available log levels string representations toward their identifier....
Definition: clutchlog.h:590
-
clutchlog::out
void out(std::ostream &out)
Set the output stream on which to print.
Definition: clutchlog.h:542
-
clutchlog::fmt::fmt
fmt()
&#160;Empty constructor, only useful for a no-op formatter.
Definition: clutchlog.h:345
-
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:286
-
clutchlog::line
void line(std::string line)
Set the regular expression filtering the line location.
Definition: clutchlog.h:611
-
clutchlog::format_comment
void format_comment(const std::string &format)
Set the template string for dumps.
Definition: clutchlog.h:537
-
clutchlog::fmt::typo
typo
Typographic style codes.
Definition: clutchlog.h:336
-
CLUTCHDUMP_DEFAULT_SEP
#define CLUTCHDUMP_DEFAULT_SEP
Compile-time default item separator for dump.
Definition: clutchlog.h:235
-
CLUTCHLOG_HFILL_MARK
#define CLUTCHLOG_HFILL_MARK
Character used as a filling for right-align the right part of messages with "{hfill}".
Definition: clutchlog.h:256
-
clutchlog::default_depth_mark
static std::string default_depth_mark
Default mark for stack depth.
Definition: clutchlog.h:245
-
CLUTCHLOG_DEFAULT_FORMAT
#define CLUTCHLOG_DEFAULT_FORMAT
Compile-time default format of the messages (debug mode: with absolute location).
Definition: clutchlog.h:194
-
clutchlog::format
std::string format() const
Get the template string.
Definition: clutchlog.h:534
-
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:860
-
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:596
-
clutchlog::default_hfill_max
static unsigned short default_hfill_max
Default maximum number of character used as a filling for right-align the right part of messages with...
Definition: clutchlog.h:268
-
clutchlog::_format_dump
std::string _format_dump
Current format of the file output.
Definition: clutchlog.h:489
-
clutchlog::fmt::operator()
std::string operator()(const std::string &msg) const
Format the given string with the currently encoded format.
Definition: clutchlog.h:404
-
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:795
-
clutchlog::_format_log
std::string _format_log
Current format of the standard output.
Definition: clutchlog.h:487
-
clutchlog::level
level
Available log levels.
Definition: clutchlog.h:293
-
clutchlog::scope_t::stage
level stage
Current log level.
Definition: clutchlog.h:648
-
CLUTCHLOG_DEFAULT_DEPTH_MARK
#define CLUTCHLOG_DEFAULT_DEPTH_MARK
Compile-time default mark for stack depth.
Definition: clutchlog.h:242
-
clutchlog::fmt::operator<<
friend std::ostream & operator<<(std::ostream &os, const fmt &fmt)
Output stream overload.
Definition: clutchlog.h:389
-
clutchlog::_level_fmt
std::map< level, fmt > _level_fmt
Dictionary of level identifier to their format.
Definition: clutchlog.h:485
-
clutchlog::_in_line
std::regex _in_line
Current line location filter.
Definition: clutchlog.h:513
-
clutchlog::fmt::style
enum clutchlog::fmt::typo style
Typographic style.
-
clutchlog::_stage
level _stage
Current log level.
Definition: clutchlog.h:507
-
clutchlog::format_comment
std::string format_comment() const
Get the template string for dumps.
Definition: clutchlog.h:539
-
clutchlog::_strip_calls
size_t _strip_calls
Current number of call stack levels to remove from depth display.
Definition: clutchlog.h:479
-
CLUTCHLOG_STRIP_CALLS
#define CLUTCHLOG_STRIP_CALLS
Compile-time number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:249
-
clutchlog::_out
std::ostream * _out
Standard output.
Definition: clutchlog.h:499
-
clutchlog::func
void func(std::string func)
Set the regular expression filtering the function location.
Definition: clutchlog.h:609
-
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:614
-
clutchlog::default_hfill_char
static char default_hfill_char
Default character used as a filling for right-align the right part of messages with "{hfill}".
Definition: clutchlog.h:259
-
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:885
-
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:784
-
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:307
-
clutchlog::_in_file
std::regex _in_file
Current file location filter.
Definition: clutchlog.h:509
-
clutchlog::out
std::ostream & out()
Get the output stream on which to print.
Definition: clutchlog.h:544
-
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:719
-
clutchlog::default_strip_calls
static unsigned int default_strip_calls
Number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:252
-
clutchlog::default_format
static std::string default_format
Default format of the messages.
Definition: clutchlog.h:209
-
clutchlog::fmt::fore
enum clutchlog::fmt::fg fore
Foreground color.
-
clutchlog::threshold
void threshold(const std::string &l)
Set the log level (below which logs are not printed) with a string.
Definition: clutchlog.h:586
-
clutchlog::scope_t::there
bool there
Location is compatible.
Definition: clutchlog.h:654
-
clutchlog::scope_t
Structure holding a location matching.
Definition: clutchlog.h:644
-
clutchlog::_in_func
std::regex _in_func
Current function location filter.
Definition: clutchlog.h:511
-
clutchlog::threshold
void threshold(level l)
Set the log level (below which logs are not printed) with an identifier.
Definition: clutchlog.h:584
-
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:632
-
clutchlog::_level_word
const std::map< level, std::string > _level_word
Dictionary of level identifier to their string representation.
Definition: clutchlog.h:481
-
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:668
-
clutchlog::scope_t::matches
bool matches
Everything is compatible.
Definition: clutchlog.h:646
-
clutchlog::dump_default_sep
static std::string dump_default_sep
Default item separator for dump.
Definition: clutchlog.h:238
-
clutchlog::threshold
level threshold() const
Get the log level below which logs are not printed.
Definition: clutchlog.h:588
-
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:359
-
clutchlog::_word_level
std::map< std::string, level > _word_level
Dictionary of level string to their identifier.
Definition: clutchlog.h:483
-
clutchlog::style
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
Definition: clutchlog.h:630
-
clutchlog::scope_t::scope_t
scope_t()
Constructor.
Definition: clutchlog.h:656
-
CLUTCHLOG_HAVE_UNIX_SYSINFO
#define CLUTCHLOG_HAVE_UNIX_SYSINFO
POSIX headers necessary for stack depth management are available.
Definition: clutchlog.h:32
-
clutchlog
Definition: clutchlog.h:175
-
clutchlog::style
fmt style(level stage) const
Get the configured fmt instance of the given log level.
Definition: clutchlog.h:634
-
clutchlog::fmt::bg
bg
Background color codes.
Definition: clutchlog.h:323
-
clutchlog::fmt::back
enum clutchlog::fmt::bg back
Background color.
+
clutchlog::default_depth_mark
static std::string default_depth_mark
Default mark for stack depth.
Definition: clutchlog.h:249
+
clutchlog::_format_log
std::string _format_log
Current format of the standard output.
Definition: clutchlog.h:497
+
clutchlog::_level_fmt
std::map< level, fmt > _level_fmt
Dictionary of level identifier to their format.
Definition: clutchlog.h:495
+
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:883
+
clutchlog::fmt::str
std::string str() const
Return the formatting code as a string.
Definition: clutchlog.h:418
+
clutchlog::line
void line(std::string line)
Set the regular expression filtering the line location.
Definition: clutchlog.h:621
+
clutchlog::dump_default_format
static std::string dump_default_format
Default format of the comment line in file dump.
Definition: clutchlog.h:235
+
clutchlog::out
void out(std::ostream &out)
Set the output stream on which to print.
Definition: clutchlog.h:552
+
CLUTCHDUMP_DEFAULT_FORMAT
#define CLUTCHDUMP_DEFAULT_FORMAT
Compile-time default format of the comment line in file dump.
Definition: clutchlog.h:221
+
clutchlog::dump_default_sep
static std::string dump_default_sep
Default item separator for dump.
Definition: clutchlog.h:242
+
clutchlog::format
std::string format(std::string row, 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:805
+
CLUTCHDUMP_DEFAULT_SEP
#define CLUTCHDUMP_DEFAULT_SEP
Compile-time default item separator for dump.
Definition: clutchlog.h:239
+
clutchlog::default_strip_calls
static unsigned int default_strip_calls
Number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:256
+
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:729
+
clutchlog::fmt::back
enum clutchlog::fmt::bg back
Background color.
+
clutchlog::fmt::fg
fg
Foreground color codes.
Definition: clutchlog.h:312
+
clutchlog::fmt::fore
enum clutchlog::fmt::fg fore
Foreground color.
+
clutchlog::default_hfill_char
static char default_hfill_char
Default character used as a filling for right-align the right part of messages with "{hfill}".
Definition: clutchlog.h:263
+
clutchlog::scope_t::matches
bool matches
Everything is compatible.
Definition: clutchlog.h:656
+
clutchlog::fmt::style
enum clutchlog::fmt::typo style
Typographic style.
+
CLUTCHLOG_DEFAULT_FORMAT
#define CLUTCHLOG_DEFAULT_FORMAT
Compile-time default format of the messages (debug mode: with absolute location).
Definition: clutchlog.h:198
+
clutchlog::format_comment
void format_comment(const std::string &format)
Set the template string for dumps.
Definition: clutchlog.h:547
+
CLUTCHLOG_DEFAULT_DEPTH_MARK
#define CLUTCHLOG_DEFAULT_DEPTH_MARK
Compile-time default mark for stack depth.
Definition: clutchlog.h:246
+
clutchlog::file
void file(std::string file)
Set the regular expression filtering the file location.
Definition: clutchlog.h:617
+
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:678
+
clutchlog::fmt::fmt
fmt()
&#160;Empty constructor, only useful for a no-op formatter.
Definition: clutchlog.h:347
+
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:642
+
clutchlog::threshold
void threshold(level l)
Set the log level (below which logs are not printed) with an identifier.
Definition: clutchlog.h:594
+
CLUTCHLOG_HFILL_MARK
#define CLUTCHLOG_HFILL_MARK
Character used as a filling for right-align the right part of messages with "{hfill}".
Definition: clutchlog.h:260
+
clutchlog::threshold
level threshold() const
Get the log level below which logs are not printed.
Definition: clutchlog.h:598
+
clutchlog::level
level
Available log levels.
Definition: clutchlog.h:298
+
clutchlog::default_hfill_max
static size_t default_hfill_max
Default maximum number of character used as a filling for right-align the right part of messages with...
Definition: clutchlog.h:272
+
clutchlog::scope_t::scope_t
scope_t()
Constructor.
Definition: clutchlog.h:666
+
clutchlog::_in_func
std::regex _in_func
Current function location filter.
Definition: clutchlog.h:521
+
clutchlog::fmt::bg
bg
Background color codes.
Definition: clutchlog.h:325
+
clutchlog::default_format
static std::string default_format
Default format of the messages.
Definition: clutchlog.h:213
+
clutchlog::logger
static clutchlog & logger()
Get the logger instance.
Definition: clutchlog.h:291
+
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:908
+
clutchlog::fmt
Color and style formatter for ANSI terminal escape sequences.
Definition: clutchlog.h:309
+
clutchlog::func
void func(std::string func)
Set the regular expression filtering the function location.
Definition: clutchlog.h:619
+
clutchlog::format
std::string format() const
Get the template string.
Definition: clutchlog.h:544
+
clutchlog::_in_file
std::regex _in_file
Current file location filter.
Definition: clutchlog.h:519
+
clutchlog::style
void style(level stage, FMT... styles)
Set the style (color and typo) of the given log level.
Definition: clutchlog.h:640
+
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:606
+
clutchlog::_level_word
const std::map< level, std::string > _level_word
Dictionary of level identifier to their string representation.
Definition: clutchlog.h:491
+
CLUTCHLOG_STRIP_CALLS
#define CLUTCHLOG_STRIP_CALLS
Compile-time number of call stack levels to remove from depth display by default.
Definition: clutchlog.h:253
+
clutchlog::fmt::operator()
std::string operator()(const std::string &msg) const
Format the given string with the currently encoded format.
Definition: clutchlog.h:406
+
clutchlog::_in_line
std::regex _in_line
Current line location filter.
Definition: clutchlog.h:523
+
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:794
+
clutchlog::format_comment
std::string format_comment() const
Get the template string for dumps.
Definition: clutchlog.h:549
+
clutchlog::_format_dump
std::string _format_dump
Current format of the file output.
Definition: clutchlog.h:499
+
clutchlog::scope_t
Structure holding a location matching.
Definition: clutchlog.h:654
+
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:361
+
clutchlog::_out
std::ostream * _out
Standard output.
Definition: clutchlog.h:509
+
clutchlog::out
std::ostream & out()
Get the output stream on which to print.
Definition: clutchlog.h:554
+
clutchlog::threshold
void threshold(const std::string &l)
Set the log level (below which logs are not printed) with a string.
Definition: clutchlog.h:596
+
clutchlog::levels
const std::map< std::string, level > & levels() const
Get the map of available log levels string representations toward their identifier....
Definition: clutchlog.h:600
+
clutchlog::_strip_calls
size_t _strip_calls
Current number of call stack levels to remove from depth display.
Definition: clutchlog.h:489
+
clutchlog::scope_t::stage
level stage
Current log level.
Definition: clutchlog.h:658
+
clutchlog::scope_t::there
bool there
Location is compatible.
Definition: clutchlog.h:664
+
clutchlog::fmt::operator<<
friend std::ostream & operator<<(std::ostream &os, const fmt &fmt)
Output stream overload.
Definition: clutchlog.h:391
+
clutchlog::_word_level
std::map< std::string, level > _word_level
Dictionary of level string to their identifier.
Definition: clutchlog.h:493
+
clutchlog::_stage
level _stage
Current log level.
Definition: clutchlog.h:517
+
clutchlog::style
fmt style(level stage) const
Get the configured fmt instance of the given log level.
Definition: clutchlog.h:644
+
clutchlog::fmt::typo
typo
Typographic style codes.
Definition: clutchlog.h:338
+
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:624
+
CLUTCHLOG_HAVE_UNIX_SYSINFO
#define CLUTCHLOG_HAVE_UNIX_SYSINFO
True if POSIX headers necessary for stack depth management are available.
Definition: clutchlog.h:33
+
clutchlog
The single class which holds everything.
Definition: clutchlog.h:177
Generated by   diff --git a/docs/dir_0597ce40fdf188e7870807c32590691d.html b/docs/dir_0597ce40fdf188e7870807c32590691d.html index b8f5df4..b6c5152 100644 --- a/docs/dir_0597ce40fdf188e7870807c32590691d.html +++ b/docs/dir_0597ce40fdf188e7870807c32590691d.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_084dfc9a5a5be3c9e27543ac1f550db2.html b/docs/dir_084dfc9a5a5be3c9e27543ac1f550db2.html index 3fa4431..cd756a5 100644 --- a/docs/dir_084dfc9a5a5be3c9e27543ac1f550db2.html +++ b/docs/dir_084dfc9a5a5be3c9e27543ac1f550db2.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_0c6859326e57c84153d9ce3980c7b614.html b/docs/dir_0c6859326e57c84153d9ce3980c7b614.html index fd53b36..42ddfa1 100644 --- a/docs/dir_0c6859326e57c84153d9ce3980c7b614.html +++ b/docs/dir_0c6859326e57c84153d9ce3980c7b614.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_10ddb028b6670bd8aa01364e6cad76a9.html b/docs/dir_10ddb028b6670bd8aa01364e6cad76a9.html index 4994012..f8f26a4 100644 --- a/docs/dir_10ddb028b6670bd8aa01364e6cad76a9.html +++ b/docs/dir_10ddb028b6670bd8aa01364e6cad76a9.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_10e5b046fa80f4154fb6ef98b74319ee.html b/docs/dir_10e5b046fa80f4154fb6ef98b74319ee.html index b1f5cfe..63bb098 100644 --- a/docs/dir_10e5b046fa80f4154fb6ef98b74319ee.html +++ b/docs/dir_10e5b046fa80f4154fb6ef98b74319ee.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_11d96b0893f97b142d6effd564752a90.html b/docs/dir_11d96b0893f97b142d6effd564752a90.html index 57d3c79..35a673e 100644 --- a/docs/dir_11d96b0893f97b142d6effd564752a90.html +++ b/docs/dir_11d96b0893f97b142d6effd564752a90.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_13368ad9184bbad1002e036a402da7c4.html b/docs/dir_13368ad9184bbad1002e036a402da7c4.html index db3a793..7ba2ae0 100644 --- a/docs/dir_13368ad9184bbad1002e036a402da7c4.html +++ b/docs/dir_13368ad9184bbad1002e036a402da7c4.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_14f0b626af56b1ff4afcbb0dad5c9b00.html b/docs/dir_14f0b626af56b1ff4afcbb0dad5c9b00.html index dbea137..474765a 100644 --- a/docs/dir_14f0b626af56b1ff4afcbb0dad5c9b00.html +++ b/docs/dir_14f0b626af56b1ff4afcbb0dad5c9b00.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_178d547a078d4731b3af021ed5ed0bd5.html b/docs/dir_178d547a078d4731b3af021ed5ed0bd5.html index 47d53b4..27aaec9 100644 --- a/docs/dir_178d547a078d4731b3af021ed5ed0bd5.html +++ b/docs/dir_178d547a078d4731b3af021ed5ed0bd5.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_183919ee65eb1ce3e4c28765d02d1592.html b/docs/dir_183919ee65eb1ce3e4c28765d02d1592.html index b63e1ee..2db43e7 100644 --- a/docs/dir_183919ee65eb1ce3e4c28765d02d1592.html +++ b/docs/dir_183919ee65eb1ce3e4c28765d02d1592.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_2010fee6dc55af84ec3880814fe9859d.html b/docs/dir_2010fee6dc55af84ec3880814fe9859d.html index fd594eb..ad146c0 100644 --- a/docs/dir_2010fee6dc55af84ec3880814fe9859d.html +++ b/docs/dir_2010fee6dc55af84ec3880814fe9859d.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_232d0e660737fa098457ae695f029c6e.html b/docs/dir_232d0e660737fa098457ae695f029c6e.html index 70b831c..e236c94 100644 --- a/docs/dir_232d0e660737fa098457ae695f029c6e.html +++ b/docs/dir_232d0e660737fa098457ae695f029c6e.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_27117ea8c3a88700c8b1db11c9562238.html b/docs/dir_27117ea8c3a88700c8b1db11c9562238.html index d3519f1..9c42e87 100644 --- a/docs/dir_27117ea8c3a88700c8b1db11c9562238.html +++ b/docs/dir_27117ea8c3a88700c8b1db11c9562238.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_2c58f47b9ec63c233e9a6dc44b0220ce.html b/docs/dir_2c58f47b9ec63c233e9a6dc44b0220ce.html index 06da2f2..d3837bc 100644 --- a/docs/dir_2c58f47b9ec63c233e9a6dc44b0220ce.html +++ b/docs/dir_2c58f47b9ec63c233e9a6dc44b0220ce.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3353b0403823e43b133a3a97f7b61528.html b/docs/dir_3353b0403823e43b133a3a97f7b61528.html index 98f5165..49d8f6c 100644 --- a/docs/dir_3353b0403823e43b133a3a97f7b61528.html +++ b/docs/dir_3353b0403823e43b133a3a97f7b61528.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3354f823b93c486985d8eff812f202d0.html b/docs/dir_3354f823b93c486985d8eff812f202d0.html index 7cd9939..aa8e3e7 100644 --- a/docs/dir_3354f823b93c486985d8eff812f202d0.html +++ b/docs/dir_3354f823b93c486985d8eff812f202d0.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3580e889fffd597e9f1e74f0989be3f4.html b/docs/dir_3580e889fffd597e9f1e74f0989be3f4.html index 0693e41..f555b33 100644 --- a/docs/dir_3580e889fffd597e9f1e74f0989be3f4.html +++ b/docs/dir_3580e889fffd597e9f1e74f0989be3f4.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_38468fa15d001d8f53eb5a2cc819fc4d.html b/docs/dir_38468fa15d001d8f53eb5a2cc819fc4d.html index 88fb315..28ca972 100644 --- a/docs/dir_38468fa15d001d8f53eb5a2cc819fc4d.html +++ b/docs/dir_38468fa15d001d8f53eb5a2cc819fc4d.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3b27b7a7434122ddfe41170c43d31183.html b/docs/dir_3b27b7a7434122ddfe41170c43d31183.html index 262d4c2..5c59468 100644 --- a/docs/dir_3b27b7a7434122ddfe41170c43d31183.html +++ b/docs/dir_3b27b7a7434122ddfe41170c43d31183.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3b3b5af829689cf9fc261f0e6a0edda6.html b/docs/dir_3b3b5af829689cf9fc261f0e6a0edda6.html index 1ae8143..5c8c789 100644 --- a/docs/dir_3b3b5af829689cf9fc261f0e6a0edda6.html +++ b/docs/dir_3b3b5af829689cf9fc261f0e6a0edda6.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3e1bb72ed66f215303e7248107b2c843.html b/docs/dir_3e1bb72ed66f215303e7248107b2c843.html index 617e912..2e3056d 100644 --- a/docs/dir_3e1bb72ed66f215303e7248107b2c843.html +++ b/docs/dir_3e1bb72ed66f215303e7248107b2c843.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_3e4d9bbf23e4011a0d79c59ef1fbe4fa.html b/docs/dir_3e4d9bbf23e4011a0d79c59ef1fbe4fa.html index 776bffe..2a4172a 100644 --- a/docs/dir_3e4d9bbf23e4011a0d79c59ef1fbe4fa.html +++ b/docs/dir_3e4d9bbf23e4011a0d79c59ef1fbe4fa.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_44d46ce0fefad9fb4568613342a0f089.html b/docs/dir_44d46ce0fefad9fb4568613342a0f089.html index 7b704c4..197ca91 100644 --- a/docs/dir_44d46ce0fefad9fb4568613342a0f089.html +++ b/docs/dir_44d46ce0fefad9fb4568613342a0f089.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_49bf50162b43c6eb0e5d51c9a154dd85.html b/docs/dir_49bf50162b43c6eb0e5d51c9a154dd85.html index 4654d46..db86bfc 100644 --- a/docs/dir_49bf50162b43c6eb0e5d51c9a154dd85.html +++ b/docs/dir_49bf50162b43c6eb0e5d51c9a154dd85.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_56412180890141897a46e337654f67d2.html b/docs/dir_56412180890141897a46e337654f67d2.html index bab8945..b27fc29 100644 --- a/docs/dir_56412180890141897a46e337654f67d2.html +++ b/docs/dir_56412180890141897a46e337654f67d2.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_56a467a6a3c52bfafa193ec205c1fdda.html b/docs/dir_56a467a6a3c52bfafa193ec205c1fdda.html index 7a1aa0b..7bbf0bf 100644 --- a/docs/dir_56a467a6a3c52bfafa193ec205c1fdda.html +++ b/docs/dir_56a467a6a3c52bfafa193ec205c1fdda.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_581e3e812319f368929566c0af58ce01.html b/docs/dir_581e3e812319f368929566c0af58ce01.html index 661b2e6..1dbe38d 100644 --- a/docs/dir_581e3e812319f368929566c0af58ce01.html +++ b/docs/dir_581e3e812319f368929566c0af58ce01.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html index f4c860b..0805363 100644 --- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html +++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -77,7 +77,7 @@ Directory dependency graph for tests: - + diff --git a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.map index bd816e4..84d901c 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 12b5bf0..342b1f7 100644 --- a/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 +++ b/docs/dir_59425e443f801f1f2fd8bbe4959a3ccf_dep.md5 @@ -1 +1 @@ -8f7314a2f57301e34e0646dc9172b2c8 \ No newline at end of file +ad07c602c5f27262d32a2fbf060dda22 \ No newline at end of file diff --git a/docs/dir_5b4d8a0ca6574b7df09df571ad9e67b6.html b/docs/dir_5b4d8a0ca6574b7df09df571ad9e67b6.html index f81debd..c24dd78 100644 --- a/docs/dir_5b4d8a0ca6574b7df09df571ad9e67b6.html +++ b/docs/dir_5b4d8a0ca6574b7df09df571ad9e67b6.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_61ab004aa8225a3da30151b57198e21f.html b/docs/dir_61ab004aa8225a3da30151b57198e21f.html index 66967a9..fe794d0 100644 --- a/docs/dir_61ab004aa8225a3da30151b57198e21f.html +++ b/docs/dir_61ab004aa8225a3da30151b57198e21f.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_758abd5d6f4fa812820adbe21fc77736.html b/docs/dir_758abd5d6f4fa812820adbe21fc77736.html index 24276bc..a663f3c 100644 --- a/docs/dir_758abd5d6f4fa812820adbe21fc77736.html +++ b/docs/dir_758abd5d6f4fa812820adbe21fc77736.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_7993767c315ca7e2492c0e12f2140894.html b/docs/dir_7993767c315ca7e2492c0e12f2140894.html index b267992..70af627 100644 --- a/docs/dir_7993767c315ca7e2492c0e12f2140894.html +++ b/docs/dir_7993767c315ca7e2492c0e12f2140894.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_7ac2ccaca1f97cd5484903d036e6e018.html b/docs/dir_7ac2ccaca1f97cd5484903d036e6e018.html index acde7ac..7756f6f 100644 --- a/docs/dir_7ac2ccaca1f97cd5484903d036e6e018.html +++ b/docs/dir_7ac2ccaca1f97cd5484903d036e6e018.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_7bfd87e22fd8913a7cdac6885aea0fda.html b/docs/dir_7bfd87e22fd8913a7cdac6885aea0fda.html index ecc3f0d..83b8410 100644 --- a/docs/dir_7bfd87e22fd8913a7cdac6885aea0fda.html +++ b/docs/dir_7bfd87e22fd8913a7cdac6885aea0fda.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_7cb602820ef60ce7eb9af6d9eb8de17a.html b/docs/dir_7cb602820ef60ce7eb9af6d9eb8de17a.html index 3b4b1b7..4eeac3d 100644 --- a/docs/dir_7cb602820ef60ce7eb9af6d9eb8de17a.html +++ b/docs/dir_7cb602820ef60ce7eb9af6d9eb8de17a.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_818a2d2dcebf5fa9f09b2ff370a5de12.html b/docs/dir_818a2d2dcebf5fa9f09b2ff370a5de12.html index f9e59a2..fa10b00 100644 --- a/docs/dir_818a2d2dcebf5fa9f09b2ff370a5de12.html +++ b/docs/dir_818a2d2dcebf5fa9f09b2ff370a5de12.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_8497d690b57aba136d1839e5c427d666.html b/docs/dir_8497d690b57aba136d1839e5c427d666.html index d4c3fcd..3a091bc 100644 --- a/docs/dir_8497d690b57aba136d1839e5c427d666.html +++ b/docs/dir_8497d690b57aba136d1839e5c427d666.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_894f8a189fd86151cf73b234a425a3d7.html b/docs/dir_894f8a189fd86151cf73b234a425a3d7.html index 8664eac..5de8e1a 100644 --- a/docs/dir_894f8a189fd86151cf73b234a425a3d7.html +++ b/docs/dir_894f8a189fd86151cf73b234a425a3d7.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_8a6224de47695006c09a16d36b73e641.html b/docs/dir_8a6224de47695006c09a16d36b73e641.html index 35f8a35..3c5cbf3 100644 --- a/docs/dir_8a6224de47695006c09a16d36b73e641.html +++ b/docs/dir_8a6224de47695006c09a16d36b73e641.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_8c3cbcfef903547985c71f28526a37d7.html b/docs/dir_8c3cbcfef903547985c71f28526a37d7.html index 1397250..b6a454d 100644 --- a/docs/dir_8c3cbcfef903547985c71f28526a37d7.html +++ b/docs/dir_8c3cbcfef903547985c71f28526a37d7.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_99be30a3dc5b3fd221ff5ea6bdbc52f4.html b/docs/dir_99be30a3dc5b3fd221ff5ea6bdbc52f4.html index bdc817f..605321a 100644 --- a/docs/dir_99be30a3dc5b3fd221ff5ea6bdbc52f4.html +++ b/docs/dir_99be30a3dc5b3fd221ff5ea6bdbc52f4.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_99f269110bdc8201794420d5043dadef.html b/docs/dir_99f269110bdc8201794420d5043dadef.html index 3edb7f4..ecf33af 100644 --- a/docs/dir_99f269110bdc8201794420d5043dadef.html +++ b/docs/dir_99f269110bdc8201794420d5043dadef.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_9a935cfcf36ab9c047ca734a48c6ea47.html b/docs/dir_9a935cfcf36ab9c047ca734a48c6ea47.html index e7e46b5..e285d65 100644 --- a/docs/dir_9a935cfcf36ab9c047ca734a48c6ea47.html +++ b/docs/dir_9a935cfcf36ab9c047ca734a48c6ea47.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_a5e190e82988878b02be1ad8893fe33a.html b/docs/dir_a5e190e82988878b02be1ad8893fe33a.html index 6502e22..4e9a78b 100644 --- a/docs/dir_a5e190e82988878b02be1ad8893fe33a.html +++ b/docs/dir_a5e190e82988878b02be1ad8893fe33a.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_a6147547081efd8e9250c1acee302c56.html b/docs/dir_a6147547081efd8e9250c1acee302c56.html index 1b77d02..bb3f6b5 100644 --- a/docs/dir_a6147547081efd8e9250c1acee302c56.html +++ b/docs/dir_a6147547081efd8e9250c1acee302c56.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_a808995e8af62dcd5e402dfccd15597d.html b/docs/dir_a808995e8af62dcd5e402dfccd15597d.html index 8199c2e..28dade9 100644 --- a/docs/dir_a808995e8af62dcd5e402dfccd15597d.html +++ b/docs/dir_a808995e8af62dcd5e402dfccd15597d.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_a943a781f3047d1fe445d5e8eba50028.html b/docs/dir_a943a781f3047d1fe445d5e8eba50028.html index 7abd868..1e541b0 100644 --- a/docs/dir_a943a781f3047d1fe445d5e8eba50028.html +++ b/docs/dir_a943a781f3047d1fe445d5e8eba50028.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_b1c763aea5b862e235cc9501e2ce06da.html b/docs/dir_b1c763aea5b862e235cc9501e2ce06da.html index bad3a16..c4bf2c1 100644 --- a/docs/dir_b1c763aea5b862e235cc9501e2ce06da.html +++ b/docs/dir_b1c763aea5b862e235cc9501e2ce06da.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_b2c0fc6d3625db437ca13cb01c2a2d25.html b/docs/dir_b2c0fc6d3625db437ca13cb01c2a2d25.html index d01337d..5e2b9af 100644 --- a/docs/dir_b2c0fc6d3625db437ca13cb01c2a2d25.html +++ b/docs/dir_b2c0fc6d3625db437ca13cb01c2a2d25.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_be65af4ad555fa38f52fdec43511df23.html b/docs/dir_be65af4ad555fa38f52fdec43511df23.html index a2e6400..86eefc1 100644 --- a/docs/dir_be65af4ad555fa38f52fdec43511df23.html +++ b/docs/dir_be65af4ad555fa38f52fdec43511df23.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_bf56be71754e1b48f8f3e417eb89bb69.html b/docs/dir_bf56be71754e1b48f8f3e417eb89bb69.html index b36df57..8c80f6d 100644 --- a/docs/dir_bf56be71754e1b48f8f3e417eb89bb69.html +++ b/docs/dir_bf56be71754e1b48f8f3e417eb89bb69.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_c318bd5cf14aaa5601e6029e0b5b4048.html b/docs/dir_c318bd5cf14aaa5601e6029e0b5b4048.html index edbd545..c58c1d0 100644 --- a/docs/dir_c318bd5cf14aaa5601e6029e0b5b4048.html +++ b/docs/dir_c318bd5cf14aaa5601e6029e0b5b4048.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_c6d9c1238235b0a4853a9dfbf2961dcc.html b/docs/dir_c6d9c1238235b0a4853a9dfbf2961dcc.html index 7876385..1349a77 100644 --- a/docs/dir_c6d9c1238235b0a4853a9dfbf2961dcc.html +++ b/docs/dir_c6d9c1238235b0a4853a9dfbf2961dcc.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_c9d710504e3415cd6c2884f7df804eda.html b/docs/dir_c9d710504e3415cd6c2884f7df804eda.html index 922bf17..4c5b8aa 100644 --- a/docs/dir_c9d710504e3415cd6c2884f7df804eda.html +++ b/docs/dir_c9d710504e3415cd6c2884f7df804eda.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_dd500134467ec65427366f3cbbc5ff81.html b/docs/dir_dd500134467ec65427366f3cbbc5ff81.html index aa6220c..fbd3270 100644 --- a/docs/dir_dd500134467ec65427366f3cbbc5ff81.html +++ b/docs/dir_dd500134467ec65427366f3cbbc5ff81.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_de06b53c2e04c67b773395f92873ff7f.html b/docs/dir_de06b53c2e04c67b773395f92873ff7f.html index a28910b..3658565 100644 --- a/docs/dir_de06b53c2e04c67b773395f92873ff7f.html +++ b/docs/dir_de06b53c2e04c67b773395f92873ff7f.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_e486d5210108a359e139a984535147fa.html b/docs/dir_e486d5210108a359e139a984535147fa.html index f96169f..e3fb663 100644 --- a/docs/dir_e486d5210108a359e139a984535147fa.html +++ b/docs/dir_e486d5210108a359e139a984535147fa.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_ec4f48f1c0ac567d297185d46cf69b0c.html b/docs/dir_ec4f48f1c0ac567d297185d46cf69b0c.html index c7fc04f..f7ad29e 100644 --- a/docs/dir_ec4f48f1c0ac567d297185d46cf69b0c.html +++ b/docs/dir_ec4f48f1c0ac567d297185d46cf69b0c.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_ede0e87241159758c1b375c196bd55d8.html b/docs/dir_ede0e87241159758c1b375c196bd55d8.html index 8520531..7d3881b 100644 --- a/docs/dir_ede0e87241159758c1b375c196bd55d8.html +++ b/docs/dir_ede0e87241159758c1b375c196bd55d8.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_f324b8056e3921282ea6aa7d15c7705c.html b/docs/dir_f324b8056e3921282ea6aa7d15c7705c.html index c81c26d..73db9ca 100644 --- a/docs/dir_f324b8056e3921282ea6aa7d15c7705c.html +++ b/docs/dir_f324b8056e3921282ea6aa7d15c7705c.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_f544411fb6a30872da080b65ab4522b8.html b/docs/dir_f544411fb6a30872da080b65ab4522b8.html index c57c17c..6b84e22 100644 --- a/docs/dir_f544411fb6a30872da080b65ab4522b8.html +++ b/docs/dir_f544411fb6a30872da080b65ab4522b8.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_f792a45ec812fbfe638a4ac0a7328817.html b/docs/dir_f792a45ec812fbfe638a4ac0a7328817.html index 1b98a40..724c564 100644 --- a/docs/dir_f792a45ec812fbfe638a4ac0a7328817.html +++ b/docs/dir_f792a45ec812fbfe638a4ac0a7328817.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/dir_f803ec176eda9a8494dc55dc57236527.html b/docs/dir_f803ec176eda9a8494dc55dc57236527.html index c7d76c3..cfc0cc7 100644 --- a/docs/dir_f803ec176eda9a8494dc55dc57236527.html +++ b/docs/dir_f803ec176eda9a8494dc55dc57236527.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/files.html b/docs/files.html index 80f4407..dc0194d 100644 --- a/docs/files.html +++ b/docs/files.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
diff --git a/docs/functions.html b/docs/functions.html index e16a916..d0908ba 100644 --- a/docs/functions.html +++ b/docs/functions.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -66,189 +66,192 @@ $(function() {

- _ -

- b -

- d -

- f -

- l -

- m -

- o -

- p -

- r -

- s -

- t -

diff --git a/docs/functions_enum.html b/docs/functions_enum.html index 7dd3ef1..e1860cd 100644 --- a/docs/functions_enum.html +++ b/docs/functions_enum.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -64,16 +64,16 @@ $(function() {
 
diff --git a/docs/functions_func.html b/docs/functions_func.html index 28708c6..fbec935 100644 --- a/docs/functions_func.html +++ b/docs/functions_func.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -64,64 +64,67 @@ $(function() {
 
diff --git a/docs/functions_rela.html b/docs/functions_rela.html index ec7b957..25ecd9e 100644 --- a/docs/functions_rela.html +++ b/docs/functions_rela.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -64,7 +64,7 @@ $(function() {
 
diff --git a/docs/functions_vars.html b/docs/functions_vars.html index ecf71dd..2095fd4 100644 --- a/docs/functions_vars.html +++ b/docs/functions_vars.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -64,76 +64,76 @@ $(function() {
 
diff --git a/docs/globals.html b/docs/globals.html index 83ff209..0396458 100644 --- a/docs/globals.html +++ b/docs/globals.html @@ -22,7 +22,7 @@
clutchlog -  0.10 +  0.11
@@ -70,10 +70,10 @@ $(function() { : clutchlog.h
  • CLUTCHDUMP_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHDUMP_DEFAULT_SEP -: clutchlog.h +: clutchlog.h
  • CLUTCHFUNC : clutchlog.h @@ -85,22 +85,28 @@ $(function() { : clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_MARK -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h +
    • +
  • CLUTCHLOG_H +: clutchlog.h
  • CLUTCHLOG_HAVE_UNIX_SYSINFO : clutchlog.h
    • +
  • CLUTCHLOG_HAVE_UNIX_SYSIOCTL +: clutchlog.h +
  • CLUTCHLOG_HFILL_MARK -: 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 d3bced4..29e325b 100644 --- a/docs/globals_defs.html +++ b/docs/globals_defs.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -70,10 +70,10 @@ $(function() { : clutchlog.h
  • CLUTCHDUMP_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h
  • CLUTCHDUMP_DEFAULT_SEP -: clutchlog.h +: clutchlog.h
  • CLUTCHFUNC : clutchlog.h @@ -85,22 +85,28 @@ $(function() { : clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_DEPTH_MARK -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_DEFAULT_FORMAT -: clutchlog.h +: clutchlog.h +
    • +
  • CLUTCHLOG_H +: clutchlog.h
  • CLUTCHLOG_HAVE_UNIX_SYSINFO : clutchlog.h
    • +
  • CLUTCHLOG_HAVE_UNIX_SYSIOCTL +: clutchlog.h +
  • CLUTCHLOG_HFILL_MARK -: clutchlog.h +: clutchlog.h
  • CLUTCHLOG_STRIP_CALLS -: clutchlog.h +: clutchlog.h
  • WITH_CLUTCHLOG : clutchlog.h diff --git a/docs/graph_legend.html b/docs/graph_legend.html index 99c0257..2978dfe 100644 --- a/docs/graph_legend.html +++ b/docs/graph_legend.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    diff --git a/docs/group__DefaultConfigMacros.html b/docs/group__DefaultConfigMacros.html index e45c799..a76587c 100644 --- a/docs/group__DefaultConfigMacros.html +++ b/docs/group__DefaultConfigMacros.html @@ -63,21 +63,618 @@ $(function() {
    -Macros
    +Modules | +Classes | +Macros | +Enumerations | +Enumerator | +Functions | +Variables | +Friends
    Default configuration macros
    +
    +Collaboration diagram for Default configuration macros:
    +
    +
    + + + + +
    + + + +

    +Modules

     Formating tools
     
    + + + + +

    +Classes

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

    Macros

    #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_FORMAT   "{level_letter} {msg}\t\t\t\t\t{func} @ {file}:{line}\n"
     Compile-time default format of the messages (debug mode: with absolute location).
     
    +#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}"
     Compile-time default format of the comment line in file dump.
     
    +#define CLUTCHDUMP_DEFAULT_SEP   "\n"
     Compile-time default item separator for dump.
     
    +#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">"
     Compile-time default mark for stack depth.
     
    +#define CLUTCHLOG_STRIP_CALLS   5
     Compile-time number of call stack levels to remove from depth display by default.
     
    +#define CLUTCHLOG_HFILL_MARK   '.'
     Character used as a filling for right-align the right part of messages with "{hfill}".
     
    + + + + + + + + + + +

    +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...
     
    +std::string clutchlog::fmt::str () const
     Return the formatting code as a string.
     
    + clutchlog::scope_t::scope_t ()
     Constructor.
     
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    +Variables

    +static std::string clutchlog::default_format = CLUTCHLOG_DEFAULT_FORMAT
     Default format of the messages.
     
    +static std::string clutchlog::dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
     Default format of the comment line in file dump.
     
    +static std::string clutchlog::dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
     Default item separator for dump.
     
    +static std::string clutchlog::default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
     Default mark for stack depth.
     
    +static unsigned int clutchlog::default_strip_calls = CLUTCHLOG_STRIP_CALLS
     Number of call stack levels to remove from depth display by default.
     
    +static char clutchlog::default_hfill_char = CLUTCHLOG_HFILL_MARK
     Default character used as a filling for right-align the right part of messages with "{hfill}".
     
    +static unsigned short clutchlog::default_hfill_max = CLUTCHLOG_HFILL_MAX
     Default maximum number of character used as a filling for right-align the right part of messages with "{hfill}".
     
    +enum clutchlog::fmt::fg clutchlog::fmt::fore
     Foreground color.
     
    +enum clutchlog::fmt::bg clutchlog::fmt::back
     Background color.
     
    +enum clutchlog::fmt::typo clutchlog::fmt::style
     Typographic style.
     
    +bool clutchlog::scope_t::matches
     Everything is compatible.
     
    +level clutchlog::scope_t::stage
     Current log level.
     
    +bool clutchlog::scope_t::there
     Location is compatible.
     
    + + + + +

    +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

    +size_t clutchlog::_strip_calls
     Current number of call stack levels to remove from depth display.
     
    +const std::map< level, std::string > clutchlog::_level_word
     Dictionary of level identifier to their string representation.
     
    +std::map< std::string, level > clutchlog::_word_level
     Dictionary of level string to their identifier.
     
    +std::map< level, fmt > clutchlog::_level_fmt
     Dictionary of level identifier to their format.
     
    +std::string clutchlog::_format_log
     Current format of the standard output.
     
    +std::string clutchlog::_format_dump
     Current format of the file output.
     
    +std::ostream * clutchlog::_out
     Standard output.
     
    +level clutchlog::_stage
     Current log level.
     
    +std::regex clutchlog::_in_file
     Current file location filter.
     
    +std::regex clutchlog::_in_func
     Current function location filter.
     
    +std::regex clutchlog::_in_line
     Current line location filter.
     
    + 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) with an identifier.
     
    +void clutchlog::threshold (const std::string &l)
     Set the log level (below which logs are not printed) with a string.
     
    +level clutchlog::threshold () const
     Get the log level below which logs are not printed.
     
    +const std::map< std::string, level > & clutchlog::levels () const
     Get the map of available log levels string representations toward their identifier. *‍/.
     
    level clutchlog::level_of (const std::string name)
     Return the log level tag corresponding to the given pre-configured name. More...
     
    +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.
     
    + + + + + + + + + + + + + + + + + + + + +

    +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

    +

    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.
    + +
    +
    +
    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:873
    +
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:288
    +
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:306
    Generated by   diff --git a/docs/group__Formating.html b/docs/group__Formating.html index 8b52015..8673398 100644 --- a/docs/group__Formating.html +++ b/docs/group__Formating.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -65,18 +65,9 @@ $(function() {
    Classes
    -
    Formating tools
    High-level API macros
    +
    Formating tools
    -
    -Collaboration diagram for Formating tools:
    -
    -
    - - - - -
    diff --git a/docs/group__Formating.map b/docs/group__Formating.map index 4852c2d..b9177bd 100644 --- a/docs/group__Formating.map +++ b/docs/group__Formating.map @@ -1,4 +1,4 @@ - - + + diff --git a/docs/group__Formating.md5 b/docs/group__Formating.md5 index e3f736f..7f04af5 100644 --- a/docs/group__Formating.md5 +++ b/docs/group__Formating.md5 @@ -1 +1 @@ -1526136908b0b9cdc8c0b8c2871dff28 \ No newline at end of file +a5c563d31591cb2cb96ebbd032892a64 \ No newline at end of file diff --git a/docs/group__Formating.png b/docs/group__Formating.png index b45f796..716a0e9 100644 Binary files a/docs/group__Formating.png and b/docs/group__Formating.png differ diff --git a/docs/group__Main.html b/docs/group__Main.html index 13ddddb..ef9842d 100644 --- a/docs/group__Main.html +++ b/docs/group__Main.html @@ -22,7 +22,7 @@ @@ -68,18 +68,14 @@ $(function() {
    Main class
    - -

    The single class which holds everything. -More...

    Classes

    clutchlog -  0.10 +  0.11
    +

    Classes

    class  clutchlog
     The single class which holds everything. More...
     

    Detailed Description

    -

    The single class which holds everything.

    -

    This is a Singleton class.

    diff --git a/docs/group__UseMacros.html b/docs/group__UseMacros.html index 852d269..f0271eb 100644 --- a/docs/group__UseMacros.html +++ b/docs/group__UseMacros.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -63,39 +63,12 @@ $(function() {
    -Modules | -Classes | -Macros | -Enumerations | -Enumerator | -Functions | -Variables | -Friends
    +Macros
    High-level API macros
    -
    -Collaboration diagram for High-level API macros:
    -
    -
    - - - - -
    - - - -

    -Modules

     Formating tools
     
    - - - - -

    -Classes

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

    Macros

    @@ -114,350 +87,6 @@ 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"
     Compile-time default format of the messages (debug mode: with absolute location).
     
    -#define CLUTCHDUMP_DEFAULT_FORMAT   "# {level} in {func} @ {file}:{line}"
     Compile-time default format of the comment line in file dump.
     
    -#define CLUTCHDUMP_DEFAULT_SEP   "\n"
     Compile-time default item separator for dump.
     
    -#define CLUTCHLOG_DEFAULT_DEPTH_MARK   ">"
     Compile-time default mark for stack depth.
     
    -#define CLUTCHLOG_STRIP_CALLS   5
     Compile-time number of call stack levels to remove from depth display by default.
     
    -#define CLUTCHLOG_HFILL_MARK   '.'
     Character used as a filling for right-align the right part of messages with "{hfill}".
     
    - - - - - - - - - - -

    -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...
     
    - clutchlog::scope_t::scope_t ()
     Constructor.
     
    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

    -Variables

    -static std::string clutchlog::default_format = CLUTCHLOG_DEFAULT_FORMAT
     Default format of the messages.
     
    -static std::string clutchlog::dump_default_format = CLUTCHDUMP_DEFAULT_FORMAT
     Default format of the comment line in file dump.
     
    -static std::string clutchlog::dump_default_sep = CLUTCHDUMP_DEFAULT_SEP
     Default item separator for dump.
     
    -static std::string clutchlog::default_depth_mark = CLUTCHLOG_DEFAULT_DEPTH_MARK
     Default mark for stack depth.
     
    -static unsigned int clutchlog::default_strip_calls = CLUTCHLOG_STRIP_CALLS
     Number of call stack levels to remove from depth display by default.
     
    -static char clutchlog::default_hfill_char = CLUTCHLOG_HFILL_MARK
     Default character used as a filling for right-align the right part of messages with "{hfill}".
     
    -static unsigned short clutchlog::default_hfill_max = CLUTCHLOG_HFILL_MAX
     Default maximum number of character used as a filling for right-align the right part of messages with "{hfill}".
     
    -enum clutchlog::fmt::fg clutchlog::fmt::fore
     Foreground color.
     
    -enum clutchlog::fmt::bg clutchlog::fmt::back
     Background color.
     
    -enum clutchlog::fmt::typo clutchlog::fmt::style
     Typographic style.
     
    -bool clutchlog::scope_t::matches
     Everything is compatible.
     
    -level clutchlog::scope_t::stage
     Current log level.
     
    -bool clutchlog::scope_t::there
     Location is compatible.
     
    - - - - -

    -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

    -size_t clutchlog::_strip_calls
     Current number of call stack levels to remove from depth display.
     
    -const std::map< level, std::string > clutchlog::_level_word
     Dictionary of level identifier to their string representation.
     
    -std::map< std::string, level > clutchlog::_word_level
     Dictionary of level string to their identifier.
     
    -std::map< level, fmt > clutchlog::_level_fmt
     Dictionary of level identifier to their format.
     
    -std::string clutchlog::_format_log
     Current format of the standard output.
     
    -std::string clutchlog::_format_dump
     Current format of the file output.
     
    -std::ostream * clutchlog::_out
     Standard output.
     
    -level clutchlog::_stage
     Current log level.
     
    -std::regex clutchlog::_in_file
     Current file location filter.
     
    -std::regex clutchlog::_in_func
     Current function location filter.
     
    -std::regex clutchlog::_in_line
     Current line location filter.
     
    - 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) with an identifier.
     
    -void clutchlog::threshold (const std::string &l)
     Set the log level (below which logs are not printed) with a string.
     
    -level clutchlog::threshold () const
     Get the log level below which logs are not printed.
     
    -const std::map< std::string, level > & clutchlog::levels () const
     Get the map of available log levels string representations toward their identifier. *‍/.
     
    level clutchlog::level_of (const std::string name)
     Return the log level tag corresponding to the given pre-configured name. More...
     
    -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.
     
    - - - - - - - - - - - - - - - - - - - - -

    -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

    @@ -487,7 +116,7 @@ All combination of constructors with different parameters orders.
    Value:
    do { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    if(clutchlog__scope.matches) { \
    __VA_ARGS__ \
    @@ -530,9 +159,9 @@ All combination of constructors with different parameters orders.
    Value:
    do { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    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)

    Dump the given container.

    @@ -571,7 +200,7 @@ All combination of constructors with different parameters orders.
    Value:
    do { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    auto& clutchlog__logger = clutchlog::logger(); \
    clutchlog::scope_t clutchlog__scope = clutchlog__logger.locate(clutchlog::level::LEVEL, CLUTCHLOC); \
    if(clutchlog__scope.matches) { \
    FUNC(__VA_ARGS__); \
    @@ -608,240 +237,19 @@ All combination of constructors with different parameters orders.
    Value:
    do { \
    -
    auto& clutchlog__logger = clutchlog::logger(); \
    +
    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.
    -
    -
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:286
    -
    CLUTCHDUMP_DEFAULT_SEP
    #define CLUTCHDUMP_DEFAULT_SEP
    Compile-time default item separator for dump.
    Definition: clutchlog.h:235
    -
    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:860
    -
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:75
    -
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:307
    +
    CLUTCHDUMP_DEFAULT_SEP
    #define CLUTCHDUMP_DEFAULT_SEP
    Compile-time default item separator for dump.
    Definition: clutchlog.h:239
    +
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:77
    +
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:291
    Generated by   diff --git a/docs/index.html b/docs/index.html index 88d8b96..e2e0141 100644 --- a/docs/index.html +++ b/docs/index.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -85,7 +85,8 @@ $(function() {
  • Examples
    • -
  • Build and tests
    • +
  • Limitations
    • +
  • Build and tests

    • 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.

    @@ -114,7 +115,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("Info"); // Log only "info", "warning", "error" or "critical" messages.
    log.file("algebra/.*"); // Will match any file in the "algebra" directory.
    @@ -162,13 +163,13 @@ Log level semantics
  • 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 threshold or level_of).

    +

    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 clutchlog::threshold or clutchlog::level_of).

    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.
    @@ -177,8 +178,8 @@ Location filtering

    Note that the case of the log levels strings matters (see below).

    Output Configuration

    -

    The output stream can be configured using the out method:

    log.out(std::clog); // Defaults to clog.
    -

    The format of the messages can be defined with the format method, passing a string with standardized tags surrounded by {}:

    log.format("{msg}");
    +

    The output stream can be configured using the clutchlog::out method:

    log.out(std::clog); // Defaults to clog.
    +

    The format of the messages can be defined with the clutchlog::format method, passing a string with standardized tags surrounded by {}:

    log.format("{msg}");

    Available tags are:

    • {msg}: the logged message,
      • @@ -186,7 +187,8 @@ Output Configuration
    • {level_letter}: the first letter of the current log level,
    • {file}: the current file (absolute path),
    • {func}: the current function,
      • -
    • {line}: the current line number.
      • +
    • {line}: the current line number,
      • +
    • {level_fmt}: the format of the current level (i.e. configured with clutchlog::style).

    Some tags are only available on POSIX operating systems as of now:

    • {name}: the name of the current binary,
      • @@ -199,7 +201,7 @@ Output Configuration

      By default, and if CLUTCHLOG_DEFAULT_FORMAT is not defined, clutchlog will not put the location-related tags in the message formats (i.e. {name}, {func}, and {line}) when not in Debug builds.

      Output style

      -

      The output can be colored differently depending on the log level.

      // Print error messages in bold red:
      +

      Output lines can be colored differently depending on the log level.

      // Print error messages in bold red:
      log.style(clutchlog::level::error, // First, the log level.
      clutchlog::fmt::fg::red, // Then the styles, in any order...
      clutchlog::fmt::typo::bold);
      @@ -207,11 +209,12 @@ Output style
      using fmt = clutchlog::fmt;
      fmt warn(fmt::fg::magenta, fmt::typo::bold);
      log.style(clutchlog::level::warning, warn);
      -

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

      +

      Note: this inserts a style marker at the very beginning of the line. If you add other styles later on the line, they will take precedence.

      +

      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:

      @@ -243,8 +246,9 @@ Output style
      << fmt(fmt::typo::reset) << " {msg}" << std::endl; // This is a reset.
      log.format(format.str());

    Note: messages at the "critical", "error" and "warning" log levels are colored by default. You may want to set their style to none if you want to stay in control of inserted colors in the format template.

    -

    The horizontal filling line (the {hfill} tag) can be configured separately with hfill_style, for example:

    log.hfill_style(clutchlog::fmt::fg::black);
    -

    +

    The horizontal filling line (the {hfill} tag) can be configured separately with clutchlog::hfill_style, for example:

    log.hfill_style(clutchlog::fmt::fg::black);
    +

    Note: this will actually reset any styling after the hfill, disabling any style you would have set for the whole message using clutchlog::format for the remaining of the message.

    +

    Advanced Usage

    More Output Configuration

    @@ -253,12 +257,12 @@ More Output Configuration

    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.

    By default, and if CLUTCHDUMP_DEFAULT_FORMAT is not defined, clutchlog will not put the location-related tags in the message formats (i.e. {file} and {line}) when not in Debug builds.

    Marks

    -

    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 character used with the {hfill} tag can be configured wth the hfill_mark method, and its default with the CLUTCHLOG_DEFAULT_HFILL_MARK macro:

    log.hfill_mark(CLUTCHLOG_DEFAULT_HFILL_MARK); // Defaults to '.'.
    -

    Clutchlog measures the width of the standard error channel. If it is redirected, it may be measured as very large. Thus, the hfill_max accessors allow to set a maximum width (in number of characters).

    log.hfill_max(CLUTCHLOG_DEFAULT_HFILL_MAX); // Defaults to 300.
    -

    Note: clutchlog will select the minimum between hfill_max and the measured number of columns in the terminal, so that you may use hfill_max as a way to constraint the output width in any cases.

    +

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

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

    The character used with the {hfill} tag can be configured wth the clutchlog::hfill_mark method, and its default with the CLUTCHLOG_DEFAULT_HFILL_MARK macro:

    log.hfill_mark(CLUTCHLOG_DEFAULT_HFILL_MARK); // Defaults to '.'.
    +

    Clutchlog measures the width of the standard error channel. If it is redirected, it may be measured as very large. Thus, the clutchlog::hfill_max accessors allow to set a maximum width (in number of characters).

    log.hfill_max(CLUTCHLOG_DEFAULT_HFILL_MAX); // Defaults to 300.
    +

    Note: clutchlog will select the minimum between clutchlog::hfill_max and the measured number of columns in the terminal, so that you may use clutchlog::hfill_max as a way to constraint the output width in any cases.

    Stack Depth

    -

    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, or calling strip_calls.

    log.strip_calls(CLUTCHLOG_STRIP_CALLS); // Defaults to 5.
    +

    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, or calling clutchlog::strip_calls.

    log.strip_calls(CLUTCHLOG_STRIP_CALLS); // Defaults to 5.

    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).

    @@ -271,11 +275,11 @@ Disabled calls

    Low-level API

    All configuration setters have a getters counterpart, with the same name but taking no parameter, for example:

    std::string mark = log.depth_mark();
    -

    To control more precisely the logging, one can use the low-level log method:

    log.log(clutchlog::level::xdebug, "hello world", "main.cpp", "main", 122);
    +

    To control more precisely the logging, one can use the low-level clutchlog::log method:

    log.log(clutchlog::level::xdebug, "hello world", "main.cpp", "main", 122);

    A helper macro can helps to fill in the location with the actual one, as seen by the compiler:

    log.log(clutchlog::level::xdebug, "hello world", CLUTCHLOC);

    A similar dump method exists:

    log.dump(clutchlog::level::xdebug, cont.begin(), cont.end(), CLUTCHLOC, "dumped_{n}.dat", "\n");
    log.dump(clutchlog::level::xdebug, cont.begin(), cont.end(), "main.cpp", "main", 122, "dumped.dat", "\n\n");
    -

    You can access the identifier of log levels with level_of:

    log.threshold( log.level_of("XDebug") ); // You have to know the exact string.
    +

    You can access the identifier of log levels with clutchlog::level_of:

    log.threshold( log.level_of("XDebug") ); // You have to know the exact string.

    (De)clutch any function call

    The CLUTHFUNC macro allows to wrap any function within the current logger.

    @@ -289,7 +293,7 @@ Low-level API
    );

    Examples

    -

    Here what you would do to setup clutchlog with the default configuration:

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

    Here what you would do to setup clutchlog with the default configuration:

    auto& log = clutchlog::logger();
    log.out(std::clog);
    // Location filtering.
    log.depth(std::numeric_limits<size_t>::max());
    @@ -301,10 +305,10 @@ Examples
    log.style(clutchlog::level::critical, clutchlog::fmt(
    clutchlog::fmt::fg::red,
    clutchlog::fmt::typo::underline);
    -
    log.style(clutchlog::level::error, clutchlog::fmt(
    +
    log.style(clutchlog::level::error, clutchlog::fmt(
    clutchlog::fmt::fg::red,
    clutchlog::fmt::typo::bold);
    -
    log.style(clutchlog::level::warning, clutchlog::fmt(
    +
    log.style(clutchlog::level::warning, clutchlog::fmt(
    clutchlog::fmt::fg::magenta,
    clutchlog::fmt::typo::bold);
    // Assuming you are on a POSIX system.
    @@ -314,28 +318,33 @@ Examples
    log.hfill_char('.');
    log.hfill_max(300);
    log.hfill_style(clutchlog::fmt::fg::none);
    -

    And here are all the functions you may call to log something: ```cpp // Basic message. CLUTCHLOG(debug, "x = " << x);

    -

    // Any code section. CLUTCHCODE(xdebug, if(x < 0) std::cerr << "WTF?" << std::endl; );

    -

    // Container to a file. CLUTCHDUMP(note, my_vector, "my_vector.dat");

    -

    // Container to a numbered file. CLUTCHDUMP(note, my_list, "my_list_{n}.dat");

    -

    // Function call. CLUTCHFUNC(warning, my_check, x, y); // Calls my_check(x,y);

    -

    // Declutchable asserts. #define ASSERT(...) { CLUTCHFUNC(critical, assert, VA_ARGS) } ASSERT(x>0);

    Limitations
    -
    ===========
    +

    And here are all the functions you may call to log something:

    // Basic message.
    +
    CLUTCHLOG(debug, "x = " << x);
    -
    ### System-dependent stack depth
    +
    // Any code section.
    +
    CLUTCHCODE(xdebug,
    +
    if(x < 0) std::cerr << "WTF?" << std::endl;
    +
    );
    -
    Because access to the call stack depth and program name are system-dependent,
    -
    the features relying on the depth of the call stack and the display of the program name
    -
    are only available for operating systems having the following headers:
    -
    `execinfo.h`, `stdlib.h` and `libgen.h` (so far, tested with Linux).
    +
    // Container to a file.
    +
    CLUTCHDUMP(note, my_vector, "my_vector.dat");
    -
    Clutchlog sets the `CLUTCHLOG_HAVE_UNIX_SYSINFO` to 1 if the headers are
    -
    available, and to 0 if they are not.
    -
    You can make portable code using something like:
    -
    ```cpp
    -
    #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
    +
    // Container to a numbered file.
    +
    CLUTCHDUMP(note, my_list, "my_list_{n}.dat");
    +
    +
    // Function call.
    +
    CLUTCHFUNC(warning, my_check, x, y); // Calls: my_check(x,y);
    +
    +
    // Declutchable asserts.
    +
    #define ASSERT(...) { CLUTCHFUNC(critical, assert, __VA_ARGS__) }
    +
    ASSERT(x>0);
    +

    +Limitations

    +

    System-dependent stack depth

    +

    Because access to the call stack depth and program name are system-dependent, the features relying on the depth of the call stack and the display of the program name are only available for operating systems having the following headers: execinfo.h, stdlib.h and libgen.h (so far, tested with Linux).

    +

    Clutchlog sets the CLUTCHLOG_HAVE_UNIX_SYSINFO to 1 if the headers are available, and to 0 if they are not. You can make portable code using something like:

    #if CLUTCHLOG_HAVE_UNIX_SYSINFO == 1
    log.depth( x );
    -
    #endif
    +
    #endif

    System-dependent horizontal fill

    Because access to the current terminal width is system-dependent, the {hfill} format tag feature is only available for operating systems having the following headers: sys/ioctl.h, stdio.h and unistd.h (so far, tested with Linux).

    Clutchlog sets the CLUTCHLOG_HAVE_UNIX_SYSIOCTL to 1 if the headers are available, and to 0 if they are not. You can make portable code using something like:

    #if CLUTCHLOG_HAVE_UNIX_SYSIOCTL == 1
    @@ -361,7 +370,7 @@ Examples
  • Automatic argument parser (please, use a dedicated lib).
  • Signal handling (WTF would you do that, anyway?).
    • -

    +

    Build and tests

    To use clutchlog, just include its header in your code and either ensure that the NDEBUG preprocessor variable is not set, either define the WITH_CLUTCHLOG preprocessor variable.

    If you're using CMake (or another modern build system), it will unset NDEBUG —and thus enable clutchlog— only for the "Debug" build type, which is usually what you want if you use clutchlog, anyway.

    @@ -373,15 +382,16 @@ Build and tests

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

    -
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:286
    -
    CLUTCHLOG
    #define CLUTCHLOG(LEVEL, WHAT)
    Log a message at the given level.
    Definition: clutchlog.h:79
    -
    CLUTCHLOG_DEFAULT_DEPTH_MARK
    #define CLUTCHLOG_DEFAULT_DEPTH_MARK
    Compile-time default mark for stack depth.
    Definition: clutchlog.h:242
    -
    clutchlog::fmt::style
    enum clutchlog::fmt::typo style
    Typographic style.
    -
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:75
    -
    CLUTCHCODE
    #define CLUTCHCODE(LEVEL,...)
    Run any code if the scope matches.
    Definition: clutchlog.h:134
    -
    CLUTCHLOG_STRIP_CALLS
    #define CLUTCHLOG_STRIP_CALLS
    Compile-time number of call stack levels to remove from depth display by default.
    Definition: clutchlog.h:249
    -
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:307
    -
    CLUTCHDUMP
    #define CLUTCHDUMP(LEVEL, CONTAINER, FILENAME)
    Dump the given container.
    Definition: clutchlog.h:96
    +
    CLUTCHLOG
    #define CLUTCHLOG(LEVEL, WHAT)
    Log a message at the given level.
    Definition: clutchlog.h:81
    +
    clutchlog::fmt::style
    enum clutchlog::fmt::typo style
    Typographic style.
    +
    CLUTCHLOC
    #define CLUTCHLOC
    Handy shortcuts to location.
    Definition: clutchlog.h:77
    +
    CLUTCHCODE
    #define CLUTCHCODE(LEVEL,...)
    Run any code if the scope matches.
    Definition: clutchlog.h:136
    +
    CLUTCHLOG_DEFAULT_DEPTH_MARK
    #define CLUTCHLOG_DEFAULT_DEPTH_MARK
    Compile-time default mark for stack depth.
    Definition: clutchlog.h:246
    +
    clutchlog::logger
    static clutchlog & logger()
    Get the logger instance.
    Definition: clutchlog.h:291
    +
    clutchlog::fmt
    Color and style formatter for ANSI terminal escape sequences.
    Definition: clutchlog.h:309
    +
    CLUTCHLOG_STRIP_CALLS
    #define CLUTCHLOG_STRIP_CALLS
    Compile-time number of call stack levels to remove from depth display by default.
    Definition: clutchlog.h:253
    +
    CLUTCHDUMP
    #define CLUTCHDUMP(LEVEL, CONTAINER, FILENAME)
    Dump the given container.
    Definition: clutchlog.h:98
    +
    CLUTCHFUNC
    #define CLUTCHFUNC(LEVEL, FUNC,...)
    Call any function if the scope matches.
    Definition: clutchlog.h:115
    Generated by   diff --git a/docs/modules.html b/docs/modules.html index cbed810..8116787 100644 --- a/docs/modules.html +++ b/docs/modules.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -67,11 +67,11 @@ $(function() {
    Here is a list of all modules:
    -
    [detail level 12]
    - - - - +
     Default configuration macros
     ▼High-level API macros
     Formating tools
     Main classThe single class which holds everything
    + + + +
     Default configuration management
     High-level API macros
     Main class
     Formating tools
    diff --git a/docs/search/all_0.js b/docs/search/all_0.js index 150660c..285176d 100644 --- a/docs/search/all_0.js +++ b/docs/search/all_0.js @@ -1,14 +1,14 @@ var searchData= [ - ['_5fformat_5fdump_0',['_format_dump',['../group__UseMacros.html#ga5f4ddb57ce42e8be86a7c7d269f7bae5',1,'clutchlog']]], - ['_5fformat_5flog_1',['_format_log',['../group__UseMacros.html#ga7c6e3fc082bc6f55d50131ed2b32e81e',1,'clutchlog']]], - ['_5fin_5ffile_2',['_in_file',['../group__UseMacros.html#gaded03528f34d9000f618419c482c5042',1,'clutchlog']]], - ['_5fin_5ffunc_3',['_in_func',['../group__UseMacros.html#ga130c4f12eacbd2028102838fe16b734e',1,'clutchlog']]], - ['_5fin_5fline_4',['_in_line',['../group__UseMacros.html#ga41757198b29862832a14472a9e5e24c6',1,'clutchlog']]], - ['_5flevel_5ffmt_5',['_level_fmt',['../group__UseMacros.html#gab805ac5c33885459f9f752518a4aa735',1,'clutchlog']]], - ['_5flevel_5fword_6',['_level_word',['../group__UseMacros.html#gab1c377a376e6772fe1746ff7147c125f',1,'clutchlog']]], - ['_5fout_7',['_out',['../group__UseMacros.html#ga1896f6c4b8597e3e76ff93970bd85167',1,'clutchlog']]], - ['_5fstage_8',['_stage',['../group__UseMacros.html#gaeb60684c89bcef5aa9273075c21cc993',1,'clutchlog']]], - ['_5fstrip_5fcalls_9',['_strip_calls',['../group__UseMacros.html#ga356df86455409193792b6ed550dfd09e',1,'clutchlog']]], - ['_5fword_5flevel_10',['_word_level',['../group__UseMacros.html#gabd4625bf211bfbaa30d9c126fa3d7888',1,'clutchlog']]] + ['_5fformat_5fdump_0',['_format_dump',['../classclutchlog.html#a5f4ddb57ce42e8be86a7c7d269f7bae5',1,'clutchlog']]], + ['_5fformat_5flog_1',['_format_log',['../classclutchlog.html#a7c6e3fc082bc6f55d50131ed2b32e81e',1,'clutchlog']]], + ['_5fin_5ffile_2',['_in_file',['../classclutchlog.html#aded03528f34d9000f618419c482c5042',1,'clutchlog']]], + ['_5fin_5ffunc_3',['_in_func',['../classclutchlog.html#a130c4f12eacbd2028102838fe16b734e',1,'clutchlog']]], + ['_5fin_5fline_4',['_in_line',['../classclutchlog.html#a41757198b29862832a14472a9e5e24c6',1,'clutchlog']]], + ['_5flevel_5ffmt_5',['_level_fmt',['../classclutchlog.html#ab805ac5c33885459f9f752518a4aa735',1,'clutchlog']]], + ['_5flevel_5fword_6',['_level_word',['../classclutchlog.html#ab1c377a376e6772fe1746ff7147c125f',1,'clutchlog']]], + ['_5fout_7',['_out',['../classclutchlog.html#a1896f6c4b8597e3e76ff93970bd85167',1,'clutchlog']]], + ['_5fstage_8',['_stage',['../classclutchlog.html#aeb60684c89bcef5aa9273075c21cc993',1,'clutchlog']]], + ['_5fstrip_5fcalls_9',['_strip_calls',['../classclutchlog.html#a356df86455409193792b6ed550dfd09e',1,'clutchlog']]], + ['_5fword_5flevel_10',['_word_level',['../classclutchlog.html#abd4625bf211bfbaa30d9c126fa3d7888',1,'clutchlog']]] ]; diff --git a/docs/search/all_1.js b/docs/search/all_1.js index 7c3ab2e..4cd6e1a 100644 --- a/docs/search/all_1.js +++ b/docs/search/all_1.js @@ -1,5 +1,5 @@ var searchData= [ - ['back_11',['back',['../group__UseMacros.html#ga86696b20e5b31c96ba592926efb324f3',1,'clutchlog::fmt']]], - ['bg_12',['bg',['../group__UseMacros.html#ga1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] + ['back_11',['back',['../classclutchlog_1_1fmt.html#a86696b20e5b31c96ba592926efb324f3',1,'clutchlog::fmt']]], + ['bg_12',['bg',['../classclutchlog_1_1fmt.html#a1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_2.js b/docs/search/all_2.js index 2f63e53..c08776c 100644 --- a/docs/search/all_2.js +++ b/docs/search/all_2.js @@ -2,17 +2,19 @@ var searchData= [ ['clutchcode_13',['CLUTCHCODE',['../group__UseMacros.html#gaaf2e85e1153e6c88b458dd49e3c37c73',1,'clutchlog.h']]], ['clutchdump_14',['CLUTCHDUMP',['../group__UseMacros.html#ga572e3aa19d8b39e3ed0b9e91961104c2',1,'clutchlog.h']]], - ['clutchdump_5fdefault_5fformat_15',['CLUTCHDUMP_DEFAULT_FORMAT',['../group__UseMacros.html#ga27b613c6727857a7cbcd0165d862034e',1,'clutchlog.h']]], - ['clutchdump_5fdefault_5fsep_16',['CLUTCHDUMP_DEFAULT_SEP',['../group__UseMacros.html#ga54d29e956575e1c731eab5406135c5df',1,'clutchlog.h']]], + ['clutchdump_5fdefault_5fformat_15',['CLUTCHDUMP_DEFAULT_FORMAT',['../group__DefaultConfig.html#ga27b613c6727857a7cbcd0165d862034e',1,'clutchlog.h']]], + ['clutchdump_5fdefault_5fsep_16',['CLUTCHDUMP_DEFAULT_SEP',['../group__DefaultConfig.html#ga54d29e956575e1c731eab5406135c5df',1,'clutchlog.h']]], ['clutchfunc_17',['CLUTCHFUNC',['../group__UseMacros.html#ga9f77cee4f853e582262930c9c17f90ae',1,'clutchlog.h']]], ['clutchloc_18',['CLUTCHLOC',['../group__UseMacros.html#gae8911119d726a43b77f5781cb5a72813',1,'clutchlog.h']]], ['clutchlog_19',['clutchlog',['../classclutchlog.html',1,'clutchlog'],['../group__UseMacros.html#ga6f86187e2b35e7e1907d688f504a197d',1,'CLUTCHLOG(): clutchlog.h']]], ['clutchlog_2eh_20',['clutchlog.h',['../clutchlog_8h.html',1,'']]], - ['clutchlog_5fdefault_5fdepth_5fbuilt_5fnodebug_21',['CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG',['../group__DefaultConfigMacros.html#ga8564be479b948ee3052b61783c66d415',1,'clutchlog.h']]], - ['clutchlog_5fdefault_5fdepth_5fmark_22',['CLUTCHLOG_DEFAULT_DEPTH_MARK',['../group__UseMacros.html#ga45c4c964fad4ad1641d5c9c28c4645b9',1,'clutchlog.h']]], - ['clutchlog_5fdefault_5fformat_23',['CLUTCHLOG_DEFAULT_FORMAT',['../group__UseMacros.html#ga524c16f280d92ee8ab683162c9ce01fa',1,'clutchlog.h']]], - ['clutchlog_5fhave_5funix_5fsysinfo_24',['CLUTCHLOG_HAVE_UNIX_SYSINFO',['../clutchlog_8h.html#a6bbcf13504687db4dbe0474931d867fb',1,'clutchlog.h']]], - ['clutchlog_5fhfill_5fmark_25',['CLUTCHLOG_HFILL_MARK',['../group__UseMacros.html#gad5fbbacf74b8e4669b8f9efdfe81bd25',1,'clutchlog.h']]], - ['clutchlog_5fstrip_5fcalls_26',['CLUTCHLOG_STRIP_CALLS',['../group__UseMacros.html#ga98f30d814d4913a8a7c93a8793f49adf',1,'clutchlog.h']]], - ['clutchlog_20—_20versatile_20_28de_29clutchable_20logging_27',['Clutchlog — versatile (de)clutchable logging',['../index.html',1,'']]] + ['clutchlog_5fdefault_5fdepth_5fbuilt_5fnodebug_21',['CLUTCHLOG_DEFAULT_DEPTH_BUILT_NODEBUG',['../group__DefaultConfig.html#ga8564be479b948ee3052b61783c66d415',1,'clutchlog.h']]], + ['clutchlog_5fdefault_5fdepth_5fmark_22',['CLUTCHLOG_DEFAULT_DEPTH_MARK',['../group__DefaultConfig.html#ga45c4c964fad4ad1641d5c9c28c4645b9',1,'clutchlog.h']]], + ['clutchlog_5fdefault_5fformat_23',['CLUTCHLOG_DEFAULT_FORMAT',['../group__DefaultConfig.html#ga524c16f280d92ee8ab683162c9ce01fa',1,'clutchlog.h']]], + ['clutchlog_5fh_24',['CLUTCHLOG_H',['../clutchlog_8h.html#a0acf7d306292cdee864356f0b433cc16',1,'clutchlog.h']]], + ['clutchlog_5fhave_5funix_5fsysinfo_25',['CLUTCHLOG_HAVE_UNIX_SYSINFO',['../clutchlog_8h.html#a6bbcf13504687db4dbe0474931d867fb',1,'clutchlog.h']]], + ['clutchlog_5fhave_5funix_5fsysioctl_26',['CLUTCHLOG_HAVE_UNIX_SYSIOCTL',['../clutchlog_8h.html#a6bddd1e1be320823da0d6b1d5cef7817',1,'clutchlog.h']]], + ['clutchlog_5fhfill_5fmark_27',['CLUTCHLOG_HFILL_MARK',['../group__DefaultConfig.html#gad5fbbacf74b8e4669b8f9efdfe81bd25',1,'clutchlog.h']]], + ['clutchlog_5fstrip_5fcalls_28',['CLUTCHLOG_STRIP_CALLS',['../group__DefaultConfig.html#ga98f30d814d4913a8a7c93a8793f49adf',1,'clutchlog.h']]], + ['clutchlog_20—_20versatile_20_28de_29clutchable_20logging_29',['Clutchlog — versatile (de)clutchable logging',['../index.html',1,'']]] ]; diff --git a/docs/search/all_3.js b/docs/search/all_3.js index 5870658..64b6460 100644 --- a/docs/search/all_3.js +++ b/docs/search/all_3.js @@ -1,12 +1,12 @@ var searchData= [ - ['default_5fdepth_5fmark_28',['default_depth_mark',['../group__UseMacros.html#ga229fd61519f1245282440120f2d45fb5',1,'clutchlog']]], - ['default_5fformat_29',['default_format',['../group__UseMacros.html#ga0c4ac57601e6f8d146fd5cc060968ecc',1,'clutchlog']]], - ['default_5fhfill_5fchar_30',['default_hfill_char',['../group__UseMacros.html#ga76eb34537b634aadb75e255f7887eeb6',1,'clutchlog']]], - ['default_5fhfill_5fmax_31',['default_hfill_max',['../group__UseMacros.html#gaa3c8e8ef6a1729b95b48f9001fc8b4c6',1,'clutchlog']]], - ['default_5fstrip_5fcalls_32',['default_strip_calls',['../group__UseMacros.html#ga1a8cb6411726133208f5a2f2cb42d468',1,'clutchlog']]], - ['default_20configuration_20macros_33',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]], - ['dump_34',['dump',['../group__UseMacros.html#ga63308e8deae3cfec6801318203494143',1,'clutchlog']]], - ['dump_5fdefault_5fformat_35',['dump_default_format',['../group__UseMacros.html#gace879554298e6e6e36dafef330c27be8',1,'clutchlog']]], - ['dump_5fdefault_5fsep_36',['dump_default_sep',['../group__UseMacros.html#gaf898bffe23b125245e338d7495c76d45',1,'clutchlog']]] + ['default_5fdepth_5fmark_30',['default_depth_mark',['../classclutchlog.html#a229fd61519f1245282440120f2d45fb5',1,'clutchlog']]], + ['default_5fformat_31',['default_format',['../classclutchlog.html#a0c4ac57601e6f8d146fd5cc060968ecc',1,'clutchlog']]], + ['default_5fhfill_5fchar_32',['default_hfill_char',['../classclutchlog.html#a76eb34537b634aadb75e255f7887eeb6',1,'clutchlog']]], + ['default_5fhfill_5fmax_33',['default_hfill_max',['../classclutchlog.html#ac95630bfe9cf547d2b7c4b3430eaedc1',1,'clutchlog']]], + ['default_5fstrip_5fcalls_34',['default_strip_calls',['../classclutchlog.html#a1a8cb6411726133208f5a2f2cb42d468',1,'clutchlog']]], + ['default_20configuration_20management_35',['Default configuration management',['../group__DefaultConfig.html',1,'']]], + ['dump_36',['dump',['../classclutchlog.html#a63308e8deae3cfec6801318203494143',1,'clutchlog']]], + ['dump_5fdefault_5fformat_37',['dump_default_format',['../classclutchlog.html#ace879554298e6e6e36dafef330c27be8',1,'clutchlog']]], + ['dump_5fdefault_5fsep_38',['dump_default_sep',['../classclutchlog.html#af898bffe23b125245e338d7495c76d45',1,'clutchlog']]] ]; diff --git a/docs/search/all_4.js b/docs/search/all_4.js index 0a0dcc5..56d9455 100644 --- a/docs/search/all_4.js +++ b/docs/search/all_4.js @@ -1,11 +1,11 @@ var searchData= [ - ['fg_37',['fg',['../group__UseMacros.html#ga4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]], - ['file_38',['file',['../group__UseMacros.html#ga10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], - ['fmt_39',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog::fmt'],['../group__UseMacros.html#ga407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt::fmt()']]], - ['fore_40',['fore',['../group__UseMacros.html#ga8307a848fcf9ed929435b3e1f2b53401',1,'clutchlog::fmt']]], - ['format_41',['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_42',['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_43',['Formating tools',['../group__Formating.html',1,'']]], - ['func_44',['func',['../group__UseMacros.html#gad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] + ['fg_39',['fg',['../classclutchlog_1_1fmt.html#a4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]], + ['file_40',['file',['../classclutchlog.html#a10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], + ['fmt_41',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog::fmt'],['../classclutchlog_1_1fmt.html#a407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt::fmt()']]], + ['fore_42',['fore',['../classclutchlog_1_1fmt.html#a8307a848fcf9ed929435b3e1f2b53401',1,'clutchlog::fmt']]], + ['format_43',['format',['../classclutchlog.html#a656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../classclutchlog.html#afc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../classclutchlog.html#abd692cca9a2e772e7c9d6531bb3c7761',1,'clutchlog::format(std::string row, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], + ['format_5fcomment_44',['format_comment',['../classclutchlog.html#a2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../classclutchlog.html#aa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], + ['formating_20tools_45',['Formating tools',['../group__Formating.html',1,'']]], + ['func_46',['func',['../classclutchlog.html#ad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] ]; diff --git a/docs/search/all_5.js b/docs/search/all_5.js index 7d68cba..6141dee 100644 --- a/docs/search/all_5.js +++ b/docs/search/all_5.js @@ -1,4 +1,4 @@ var searchData= [ - ['high_2dlevel_20api_20macros_45',['High-level API macros',['../group__UseMacros.html',1,'']]] + ['high_2dlevel_20api_20macros_47',['High-level API macros',['../group__UseMacros.html',1,'']]] ]; diff --git a/docs/search/all_6.js b/docs/search/all_6.js index 06d5032..43cc233 100644 --- a/docs/search/all_6.js +++ b/docs/search/all_6.js @@ -1,11 +1,11 @@ var searchData= [ - ['level_46',['level',['../group__UseMacros.html#ga10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]], - ['level_5fof_47',['level_of',['../group__UseMacros.html#gacebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], - ['levels_48',['levels',['../group__UseMacros.html#gaff3aa09fb60f7d6dc688c028d3834d8a',1,'clutchlog']]], - ['line_49',['line',['../group__UseMacros.html#gaa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], - ['locate_50',['locate',['../group__UseMacros.html#ga4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], - ['location_51',['location',['../group__UseMacros.html#ga6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], - ['log_52',['log',['../group__UseMacros.html#ga23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], - ['logger_53',['logger',['../group__UseMacros.html#gacfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] + ['level_48',['level',['../classclutchlog.html#a10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]], + ['level_5fof_49',['level_of',['../classclutchlog.html#acebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], + ['levels_50',['levels',['../classclutchlog.html#aff3aa09fb60f7d6dc688c028d3834d8a',1,'clutchlog']]], + ['line_51',['line',['../classclutchlog.html#aa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], + ['locate_52',['locate',['../classclutchlog.html#a4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], + ['location_53',['location',['../classclutchlog.html#a6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], + ['log_54',['log',['../classclutchlog.html#a23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], + ['logger_55',['logger',['../classclutchlog.html#acfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] ]; diff --git a/docs/search/all_7.js b/docs/search/all_7.js index a372133..d1c2026 100644 --- a/docs/search/all_7.js +++ b/docs/search/all_7.js @@ -1,5 +1,5 @@ var searchData= [ - ['main_20class_54',['Main class',['../group__Main.html',1,'']]], - ['matches_55',['matches',['../group__UseMacros.html#gae6c0e4ed20db797124ed1e5faa033ad9',1,'clutchlog::scope_t']]] + ['main_20class_56',['Main class',['../group__Main.html',1,'']]], + ['matches_57',['matches',['../structclutchlog_1_1scope__t.html#ae6c0e4ed20db797124ed1e5faa033ad9',1,'clutchlog::scope_t']]] ]; diff --git a/docs/search/all_8.js b/docs/search/all_8.js index a96ebf8..1235f9c 100644 --- a/docs/search/all_8.js +++ b/docs/search/all_8.js @@ -1,6 +1,6 @@ var searchData= [ - ['operator_28_29_56',['operator()',['../group__UseMacros.html#gafeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], - ['operator_3c_3c_57',['operator<<',['../group__UseMacros.html#ga96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]], - ['out_58',['out',['../group__UseMacros.html#ga7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../group__UseMacros.html#ga6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] + ['operator_28_29_58',['operator()',['../classclutchlog_1_1fmt.html#afeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], + ['operator_3c_3c_59',['operator<<',['../classclutchlog_1_1fmt.html#a96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]], + ['out_60',['out',['../classclutchlog.html#a7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../classclutchlog.html#a6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] ]; diff --git a/docs/search/all_9.js b/docs/search/all_9.js index d4b1f98..5b1157d 100644 --- a/docs/search/all_9.js +++ b/docs/search/all_9.js @@ -1,4 +1,4 @@ var searchData= [ - ['print_5fon_59',['print_on',['../group__UseMacros.html#ga0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] + ['print_5fon_61',['print_on',['../classclutchlog_1_1fmt.html#a0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_a.js b/docs/search/all_a.js index 08f0219..5c08b02 100644 --- a/docs/search/all_a.js +++ b/docs/search/all_a.js @@ -1,4 +1,4 @@ var searchData= [ - ['replace_60',['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']]] + ['replace_62',['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']]] ]; diff --git a/docs/search/all_b.js b/docs/search/all_b.js index fcc4676..380f842 100644 --- a/docs/search/all_b.js +++ b/docs/search/all_b.js @@ -1,6 +1,7 @@ var searchData= [ - ['scope_5ft_61',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog::scope_t'],['../group__UseMacros.html#ga0f1d865ffcf17f215e5559cdd2690572',1,'clutchlog::scope_t::scope_t()']]], - ['stage_62',['stage',['../group__UseMacros.html#gadcca6846ff90d436c61861db85917744',1,'clutchlog::scope_t']]], - ['style_63',['style',['../group__UseMacros.html#ga2bb0fde65fcd264393e102314dd1610b',1,'clutchlog::fmt::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']]] + ['scope_5ft_63',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog::scope_t'],['../structclutchlog_1_1scope__t.html#a0f1d865ffcf17f215e5559cdd2690572',1,'clutchlog::scope_t::scope_t()']]], + ['stage_64',['stage',['../structclutchlog_1_1scope__t.html#adcca6846ff90d436c61861db85917744',1,'clutchlog::scope_t']]], + ['str_65',['str',['../classclutchlog_1_1fmt.html#ab588e04e982b0b26ec979773d51ad41b',1,'clutchlog::fmt']]], + ['style_66',['style',['../classclutchlog_1_1fmt.html#a2bb0fde65fcd264393e102314dd1610b',1,'clutchlog::fmt::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']]] ]; diff --git a/docs/search/all_c.js b/docs/search/all_c.js index ab8de6b..8c3322a 100644 --- a/docs/search/all_c.js +++ b/docs/search/all_c.js @@ -1,6 +1,6 @@ var searchData= [ - ['there_64',['there',['../group__UseMacros.html#ga7918e55cd3bac1bd30c69b8c711387ff',1,'clutchlog::scope_t']]], - ['threshold_65',['threshold',['../group__UseMacros.html#ga3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../group__UseMacros.html#ga7a7738eaad114bfa870121412fe23ad9',1,'clutchlog::threshold(const std::string &l)'],['../group__UseMacros.html#gab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]], - ['typo_66',['typo',['../group__UseMacros.html#ga932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] + ['there_67',['there',['../structclutchlog_1_1scope__t.html#a7918e55cd3bac1bd30c69b8c711387ff',1,'clutchlog::scope_t']]], + ['threshold_68',['threshold',['../classclutchlog.html#a3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../classclutchlog.html#a7a7738eaad114bfa870121412fe23ad9',1,'clutchlog::threshold(const std::string &l)'],['../classclutchlog.html#ab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]], + ['typo_69',['typo',['../classclutchlog_1_1fmt.html#a932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/all_d.js b/docs/search/all_d.js index 6bbf04c..8d0c6ab 100644 --- a/docs/search/all_d.js +++ b/docs/search/all_d.js @@ -1,4 +1,4 @@ var searchData= [ - ['with_5fclutchlog_67',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] + ['with_5fclutchlog_70',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] ]; diff --git a/docs/search/classes_0.js b/docs/search/classes_0.js index 5193f82..3ee0aa9 100644 --- a/docs/search/classes_0.js +++ b/docs/search/classes_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['clutchlog_68',['clutchlog',['../classclutchlog.html',1,'']]] + ['clutchlog_71',['clutchlog',['../classclutchlog.html',1,'']]] ]; diff --git a/docs/search/classes_1.js b/docs/search/classes_1.js index c7428b5..c35d851 100644 --- a/docs/search/classes_1.js +++ b/docs/search/classes_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['fmt_69',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog']]] + ['fmt_72',['fmt',['../classclutchlog_1_1fmt.html',1,'clutchlog']]] ]; diff --git a/docs/search/classes_2.js b/docs/search/classes_2.js index ca8f490..071209a 100644 --- a/docs/search/classes_2.js +++ b/docs/search/classes_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['scope_5ft_70',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]] + ['scope_5ft_73',['scope_t',['../structclutchlog_1_1scope__t.html',1,'clutchlog']]] ]; diff --git a/docs/search/defines_0.js b/docs/search/defines_0.js index 7b8651c..9092438 100644 --- a/docs/search/defines_0.js +++ b/docs/search/defines_0.js @@ -1,4 +1,6 @@ var searchData= [ - ['clutchlog_5fhave_5funix_5fsysinfo_121',['CLUTCHLOG_HAVE_UNIX_SYSINFO',['../clutchlog_8h.html#a6bbcf13504687db4dbe0474931d867fb',1,'clutchlog.h']]] + ['clutchlog_5fh_125',['CLUTCHLOG_H',['../clutchlog_8h.html#a0acf7d306292cdee864356f0b433cc16',1,'clutchlog.h']]], + ['clutchlog_5fhave_5funix_5fsysinfo_126',['CLUTCHLOG_HAVE_UNIX_SYSINFO',['../clutchlog_8h.html#a6bbcf13504687db4dbe0474931d867fb',1,'clutchlog.h']]], + ['clutchlog_5fhave_5funix_5fsysioctl_127',['CLUTCHLOG_HAVE_UNIX_SYSIOCTL',['../clutchlog_8h.html#a6bddd1e1be320823da0d6b1d5cef7817',1,'clutchlog.h']]] ]; diff --git a/docs/search/defines_1.js b/docs/search/defines_1.js index 4d676ba..8e1d65e 100644 --- a/docs/search/defines_1.js +++ b/docs/search/defines_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['with_5fclutchlog_122',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] + ['with_5fclutchlog_128',['WITH_CLUTCHLOG',['../clutchlog_8h.html#a5c126962abcc7a40e504a6fc3abdfcc4',1,'clutchlog.h']]] ]; diff --git a/docs/search/enums_0.js b/docs/search/enums_0.js index f466b61..cba484c 100644 --- a/docs/search/enums_0.js +++ b/docs/search/enums_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['bg_116',['bg',['../group__UseMacros.html#ga1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] + ['bg_120',['bg',['../classclutchlog_1_1fmt.html#a1cf3e27e4041250ffea0a6d58010da1e',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/enums_1.js b/docs/search/enums_1.js index 4ca6f7c..1be349e 100644 --- a/docs/search/enums_1.js +++ b/docs/search/enums_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['fg_117',['fg',['../group__UseMacros.html#ga4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]] + ['fg_121',['fg',['../classclutchlog_1_1fmt.html#a4662a3ec3577c6a575a2c734636ed8a0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/enums_2.js b/docs/search/enums_2.js index 6e2964c..a1d0c6b 100644 --- a/docs/search/enums_2.js +++ b/docs/search/enums_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['level_118',['level',['../group__UseMacros.html#ga10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]] + ['level_122',['level',['../classclutchlog.html#a10fd25a1b51c8c95bd6d876ce1b4b928',1,'clutchlog']]] ]; diff --git a/docs/search/enums_3.js b/docs/search/enums_3.js index dfe50ea..b676f25 100644 --- a/docs/search/enums_3.js +++ b/docs/search/enums_3.js @@ -1,4 +1,4 @@ var searchData= [ - ['typo_119',['typo',['../group__UseMacros.html#ga932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] + ['typo_123',['typo',['../classclutchlog_1_1fmt.html#a932f47b78fb7b10590d5613a1c4eab89',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/files_0.js b/docs/search/files_0.js index f52315e..94e5d79 100644 --- a/docs/search/files_0.js +++ b/docs/search/files_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['clutchlog_2eh_71',['clutchlog.h',['../clutchlog_8h.html',1,'']]] + ['clutchlog_2eh_74',['clutchlog.h',['../clutchlog_8h.html',1,'']]] ]; diff --git a/docs/search/functions_0.js b/docs/search/functions_0.js index c1e5a9b..b601f5a 100644 --- a/docs/search/functions_0.js +++ b/docs/search/functions_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['dump_72',['dump',['../group__UseMacros.html#ga63308e8deae3cfec6801318203494143',1,'clutchlog']]] + ['dump_75',['dump',['../classclutchlog.html#a63308e8deae3cfec6801318203494143',1,'clutchlog']]] ]; diff --git a/docs/search/functions_1.js b/docs/search/functions_1.js index b7b2af1..b251e98 100644 --- a/docs/search/functions_1.js +++ b/docs/search/functions_1.js @@ -1,8 +1,8 @@ var searchData= [ - ['file_73',['file',['../group__UseMacros.html#ga10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], - ['fmt_74',['fmt',['../group__UseMacros.html#ga407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt']]], - ['format_75',['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_76',['format_comment',['../group__UseMacros.html#ga2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../group__UseMacros.html#gaa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], - ['func_77',['func',['../group__UseMacros.html#gad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] + ['file_76',['file',['../classclutchlog.html#a10064493c22f5c03b502a42d814c5c5c',1,'clutchlog']]], + ['fmt_77',['fmt',['../classclutchlog_1_1fmt.html#a407506bc02ed3f91d88b3df630e54959',1,'clutchlog::fmt']]], + ['format_78',['format',['../classclutchlog.html#a656c277e074b64728cca871f2b484d1c',1,'clutchlog::format(const std::string &format)'],['../classclutchlog.html#afc53dbca51d0e2322a21899d0c571a80',1,'clutchlog::format() const'],['../classclutchlog.html#abd692cca9a2e772e7c9d6531bb3c7761',1,'clutchlog::format(std::string row, const std::string &what, const level &stage, const std::string &file, const std::string &func, const size_t line) const']]], + ['format_5fcomment_79',['format_comment',['../classclutchlog.html#a2144abe4ec6f630126b6490908b5f924',1,'clutchlog::format_comment(const std::string &format)'],['../classclutchlog.html#aa8d0a569ed3623ce36c5e567ec2d1ad5',1,'clutchlog::format_comment() const']]], + ['func_80',['func',['../classclutchlog.html#ad32b5a0274dc03ee0004f67ba58b2447',1,'clutchlog']]] ]; diff --git a/docs/search/functions_2.js b/docs/search/functions_2.js index 2cce7d6..86da787 100644 --- a/docs/search/functions_2.js +++ b/docs/search/functions_2.js @@ -1,10 +1,10 @@ var searchData= [ - ['level_5fof_78',['level_of',['../group__UseMacros.html#gacebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], - ['levels_79',['levels',['../group__UseMacros.html#gaff3aa09fb60f7d6dc688c028d3834d8a',1,'clutchlog']]], - ['line_80',['line',['../group__UseMacros.html#gaa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], - ['locate_81',['locate',['../group__UseMacros.html#ga4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], - ['location_82',['location',['../group__UseMacros.html#ga6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], - ['log_83',['log',['../group__UseMacros.html#ga23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], - ['logger_84',['logger',['../group__UseMacros.html#gacfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] + ['level_5fof_81',['level_of',['../classclutchlog.html#acebed8c9df9204f22bf8488e62e1cedd',1,'clutchlog']]], + ['levels_82',['levels',['../classclutchlog.html#aff3aa09fb60f7d6dc688c028d3834d8a',1,'clutchlog']]], + ['line_83',['line',['../classclutchlog.html#aa26c6b81ebaeb9e9daa3457e3a3d17c9',1,'clutchlog']]], + ['locate_84',['locate',['../classclutchlog.html#a4ebdfcded6c56262676bf6926d63fc96',1,'clutchlog']]], + ['location_85',['location',['../classclutchlog.html#a6666106b9e5c239b6ae5e0d1091648e3',1,'clutchlog']]], + ['log_86',['log',['../classclutchlog.html#a23dbb98f0d3c5cc21c232cde16cf317a',1,'clutchlog']]], + ['logger_87',['logger',['../classclutchlog.html#acfaceb77da01503b432644a3efaee4fa',1,'clutchlog']]] ]; diff --git a/docs/search/functions_3.js b/docs/search/functions_3.js index 6228ad6..719d489 100644 --- a/docs/search/functions_3.js +++ b/docs/search/functions_3.js @@ -1,5 +1,5 @@ var searchData= [ - ['operator_28_29_85',['operator()',['../group__UseMacros.html#gafeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], - ['out_86',['out',['../group__UseMacros.html#ga7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../group__UseMacros.html#ga6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] + ['operator_28_29_88',['operator()',['../classclutchlog_1_1fmt.html#afeaedd18298498d1dcfcc15f5f17ac3c',1,'clutchlog::fmt']]], + ['out_89',['out',['../classclutchlog.html#a7fd7c7bd3668c537061c314a619a336d',1,'clutchlog::out(std::ostream &out)'],['../classclutchlog.html#a6c6ab42a1df147e6c2d115bc36ec8266',1,'clutchlog::out()']]] ]; diff --git a/docs/search/functions_4.js b/docs/search/functions_4.js index b49ab71..7721337 100644 --- a/docs/search/functions_4.js +++ b/docs/search/functions_4.js @@ -1,4 +1,4 @@ var searchData= [ - ['print_5fon_87',['print_on',['../group__UseMacros.html#ga0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] + ['print_5fon_90',['print_on',['../classclutchlog_1_1fmt.html#a0b607e343b6813b99eafca1fdfec9cd0',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/functions_5.js b/docs/search/functions_5.js index b399c16..e255016 100644 --- a/docs/search/functions_5.js +++ b/docs/search/functions_5.js @@ -1,4 +1,4 @@ var searchData= [ - ['replace_88',['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']]] + ['replace_91',['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']]] ]; diff --git a/docs/search/functions_6.js b/docs/search/functions_6.js index 69f6f0f..cb7636e 100644 --- a/docs/search/functions_6.js +++ b/docs/search/functions_6.js @@ -1,5 +1,6 @@ var searchData= [ - ['scope_5ft_89',['scope_t',['../group__UseMacros.html#ga0f1d865ffcf17f215e5559cdd2690572',1,'clutchlog::scope_t']]], - ['style_90',['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']]] + ['scope_5ft_92',['scope_t',['../structclutchlog_1_1scope__t.html#a0f1d865ffcf17f215e5559cdd2690572',1,'clutchlog::scope_t']]], + ['str_93',['str',['../classclutchlog_1_1fmt.html#ab588e04e982b0b26ec979773d51ad41b',1,'clutchlog::fmt']]], + ['style_94',['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']]] ]; diff --git a/docs/search/functions_7.js b/docs/search/functions_7.js index 62cd205..d7b92c8 100644 --- a/docs/search/functions_7.js +++ b/docs/search/functions_7.js @@ -1,4 +1,4 @@ var searchData= [ - ['threshold_91',['threshold',['../group__UseMacros.html#ga3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../group__UseMacros.html#ga7a7738eaad114bfa870121412fe23ad9',1,'clutchlog::threshold(const std::string &l)'],['../group__UseMacros.html#gab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]] + ['threshold_95',['threshold',['../classclutchlog.html#a3cb0e4f43a4cadf1966001ad7c9861f4',1,'clutchlog::threshold(level l)'],['../classclutchlog.html#a7a7738eaad114bfa870121412fe23ad9',1,'clutchlog::threshold(const std::string &l)'],['../classclutchlog.html#ab45287cc9c14217904a13aff49573732',1,'clutchlog::threshold() const']]] ]; diff --git a/docs/search/groups_0.js b/docs/search/groups_0.js index ae6cb05..fb66a21 100644 --- a/docs/search/groups_0.js +++ b/docs/search/groups_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['default_20configuration_20macros_123',['Default configuration macros',['../group__DefaultConfigMacros.html',1,'']]] + ['default_20configuration_20management_129',['Default configuration management',['../group__DefaultConfig.html',1,'']]] ]; diff --git a/docs/search/groups_1.js b/docs/search/groups_1.js index b800e34..039b25e 100644 --- a/docs/search/groups_1.js +++ b/docs/search/groups_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['formating_20tools_124',['Formating tools',['../group__Formating.html',1,'']]] + ['formating_20tools_130',['Formating tools',['../group__Formating.html',1,'']]] ]; diff --git a/docs/search/groups_2.js b/docs/search/groups_2.js index 47bd733..63aeae5 100644 --- a/docs/search/groups_2.js +++ b/docs/search/groups_2.js @@ -1,4 +1,4 @@ var searchData= [ - ['high_2dlevel_20api_20macros_125',['High-level API macros',['../group__UseMacros.html',1,'']]] + ['high_2dlevel_20api_20macros_131',['High-level API macros',['../group__UseMacros.html',1,'']]] ]; diff --git a/docs/search/groups_3.js b/docs/search/groups_3.js index 46a5a66..23c2a85 100644 --- a/docs/search/groups_3.js +++ b/docs/search/groups_3.js @@ -1,4 +1,4 @@ var searchData= [ - ['main_20class_126',['Main class',['../group__Main.html',1,'']]] + ['main_20class_132',['Main class',['../group__Main.html',1,'']]] ]; diff --git a/docs/search/pages_0.js b/docs/search/pages_0.js index 373e92a..d7321ca 100644 --- a/docs/search/pages_0.js +++ b/docs/search/pages_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['clutchlog_20—_20versatile_20_28de_29clutchable_20logging_127',['Clutchlog — versatile (de)clutchable logging',['../index.html',1,'']]] + ['clutchlog_20—_20versatile_20_28de_29clutchable_20logging_133',['Clutchlog — versatile (de)clutchable logging',['../index.html',1,'']]] ]; diff --git a/docs/search/related_0.js b/docs/search/related_0.js index 006be5a..3232016 100644 --- a/docs/search/related_0.js +++ b/docs/search/related_0.js @@ -1,4 +1,4 @@ var searchData= [ - ['operator_3c_3c_120',['operator<<',['../group__UseMacros.html#ga96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]] + ['operator_3c_3c_124',['operator<<',['../classclutchlog_1_1fmt.html#a96849ba427feac3a2eeaa1165e3845da',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/variables_0.js b/docs/search/variables_0.js index 0394a51..6be58af 100644 --- a/docs/search/variables_0.js +++ b/docs/search/variables_0.js @@ -1,14 +1,14 @@ var searchData= [ - ['_5fformat_5fdump_92',['_format_dump',['../group__UseMacros.html#ga5f4ddb57ce42e8be86a7c7d269f7bae5',1,'clutchlog']]], - ['_5fformat_5flog_93',['_format_log',['../group__UseMacros.html#ga7c6e3fc082bc6f55d50131ed2b32e81e',1,'clutchlog']]], - ['_5fin_5ffile_94',['_in_file',['../group__UseMacros.html#gaded03528f34d9000f618419c482c5042',1,'clutchlog']]], - ['_5fin_5ffunc_95',['_in_func',['../group__UseMacros.html#ga130c4f12eacbd2028102838fe16b734e',1,'clutchlog']]], - ['_5fin_5fline_96',['_in_line',['../group__UseMacros.html#ga41757198b29862832a14472a9e5e24c6',1,'clutchlog']]], - ['_5flevel_5ffmt_97',['_level_fmt',['../group__UseMacros.html#gab805ac5c33885459f9f752518a4aa735',1,'clutchlog']]], - ['_5flevel_5fword_98',['_level_word',['../group__UseMacros.html#gab1c377a376e6772fe1746ff7147c125f',1,'clutchlog']]], - ['_5fout_99',['_out',['../group__UseMacros.html#ga1896f6c4b8597e3e76ff93970bd85167',1,'clutchlog']]], - ['_5fstage_100',['_stage',['../group__UseMacros.html#gaeb60684c89bcef5aa9273075c21cc993',1,'clutchlog']]], - ['_5fstrip_5fcalls_101',['_strip_calls',['../group__UseMacros.html#ga356df86455409193792b6ed550dfd09e',1,'clutchlog']]], - ['_5fword_5flevel_102',['_word_level',['../group__UseMacros.html#gabd4625bf211bfbaa30d9c126fa3d7888',1,'clutchlog']]] + ['_5fformat_5fdump_96',['_format_dump',['../classclutchlog.html#a5f4ddb57ce42e8be86a7c7d269f7bae5',1,'clutchlog']]], + ['_5fformat_5flog_97',['_format_log',['../classclutchlog.html#a7c6e3fc082bc6f55d50131ed2b32e81e',1,'clutchlog']]], + ['_5fin_5ffile_98',['_in_file',['../classclutchlog.html#aded03528f34d9000f618419c482c5042',1,'clutchlog']]], + ['_5fin_5ffunc_99',['_in_func',['../classclutchlog.html#a130c4f12eacbd2028102838fe16b734e',1,'clutchlog']]], + ['_5fin_5fline_100',['_in_line',['../classclutchlog.html#a41757198b29862832a14472a9e5e24c6',1,'clutchlog']]], + ['_5flevel_5ffmt_101',['_level_fmt',['../classclutchlog.html#ab805ac5c33885459f9f752518a4aa735',1,'clutchlog']]], + ['_5flevel_5fword_102',['_level_word',['../classclutchlog.html#ab1c377a376e6772fe1746ff7147c125f',1,'clutchlog']]], + ['_5fout_103',['_out',['../classclutchlog.html#a1896f6c4b8597e3e76ff93970bd85167',1,'clutchlog']]], + ['_5fstage_104',['_stage',['../classclutchlog.html#aeb60684c89bcef5aa9273075c21cc993',1,'clutchlog']]], + ['_5fstrip_5fcalls_105',['_strip_calls',['../classclutchlog.html#a356df86455409193792b6ed550dfd09e',1,'clutchlog']]], + ['_5fword_5flevel_106',['_word_level',['../classclutchlog.html#abd4625bf211bfbaa30d9c126fa3d7888',1,'clutchlog']]] ]; diff --git a/docs/search/variables_1.js b/docs/search/variables_1.js index bc8fc6a..b432808 100644 --- a/docs/search/variables_1.js +++ b/docs/search/variables_1.js @@ -1,4 +1,4 @@ var searchData= [ - ['back_103',['back',['../group__UseMacros.html#ga86696b20e5b31c96ba592926efb324f3',1,'clutchlog::fmt']]] + ['back_107',['back',['../classclutchlog_1_1fmt.html#a86696b20e5b31c96ba592926efb324f3',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/variables_2.js b/docs/search/variables_2.js index 7e868b7..21b7370 100644 --- a/docs/search/variables_2.js +++ b/docs/search/variables_2.js @@ -1,10 +1,10 @@ var searchData= [ - ['default_5fdepth_5fmark_104',['default_depth_mark',['../group__UseMacros.html#ga229fd61519f1245282440120f2d45fb5',1,'clutchlog']]], - ['default_5fformat_105',['default_format',['../group__UseMacros.html#ga0c4ac57601e6f8d146fd5cc060968ecc',1,'clutchlog']]], - ['default_5fhfill_5fchar_106',['default_hfill_char',['../group__UseMacros.html#ga76eb34537b634aadb75e255f7887eeb6',1,'clutchlog']]], - ['default_5fhfill_5fmax_107',['default_hfill_max',['../group__UseMacros.html#gaa3c8e8ef6a1729b95b48f9001fc8b4c6',1,'clutchlog']]], - ['default_5fstrip_5fcalls_108',['default_strip_calls',['../group__UseMacros.html#ga1a8cb6411726133208f5a2f2cb42d468',1,'clutchlog']]], - ['dump_5fdefault_5fformat_109',['dump_default_format',['../group__UseMacros.html#gace879554298e6e6e36dafef330c27be8',1,'clutchlog']]], - ['dump_5fdefault_5fsep_110',['dump_default_sep',['../group__UseMacros.html#gaf898bffe23b125245e338d7495c76d45',1,'clutchlog']]] + ['default_5fdepth_5fmark_108',['default_depth_mark',['../classclutchlog.html#a229fd61519f1245282440120f2d45fb5',1,'clutchlog']]], + ['default_5fformat_109',['default_format',['../classclutchlog.html#a0c4ac57601e6f8d146fd5cc060968ecc',1,'clutchlog']]], + ['default_5fhfill_5fchar_110',['default_hfill_char',['../classclutchlog.html#a76eb34537b634aadb75e255f7887eeb6',1,'clutchlog']]], + ['default_5fhfill_5fmax_111',['default_hfill_max',['../classclutchlog.html#ac95630bfe9cf547d2b7c4b3430eaedc1',1,'clutchlog']]], + ['default_5fstrip_5fcalls_112',['default_strip_calls',['../classclutchlog.html#a1a8cb6411726133208f5a2f2cb42d468',1,'clutchlog']]], + ['dump_5fdefault_5fformat_113',['dump_default_format',['../classclutchlog.html#ace879554298e6e6e36dafef330c27be8',1,'clutchlog']]], + ['dump_5fdefault_5fsep_114',['dump_default_sep',['../classclutchlog.html#af898bffe23b125245e338d7495c76d45',1,'clutchlog']]] ]; diff --git a/docs/search/variables_3.js b/docs/search/variables_3.js index e4f71e2..101bd4a 100644 --- a/docs/search/variables_3.js +++ b/docs/search/variables_3.js @@ -1,4 +1,4 @@ var searchData= [ - ['fore_111',['fore',['../group__UseMacros.html#ga8307a848fcf9ed929435b3e1f2b53401',1,'clutchlog::fmt']]] + ['fore_115',['fore',['../classclutchlog_1_1fmt.html#a8307a848fcf9ed929435b3e1f2b53401',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/variables_4.js b/docs/search/variables_4.js index 43b4567..e30e6f3 100644 --- a/docs/search/variables_4.js +++ b/docs/search/variables_4.js @@ -1,4 +1,4 @@ var searchData= [ - ['matches_112',['matches',['../group__UseMacros.html#gae6c0e4ed20db797124ed1e5faa033ad9',1,'clutchlog::scope_t']]] + ['matches_116',['matches',['../structclutchlog_1_1scope__t.html#ae6c0e4ed20db797124ed1e5faa033ad9',1,'clutchlog::scope_t']]] ]; diff --git a/docs/search/variables_5.js b/docs/search/variables_5.js index 5c273c1..e0663fd 100644 --- a/docs/search/variables_5.js +++ b/docs/search/variables_5.js @@ -1,5 +1,5 @@ var searchData= [ - ['stage_113',['stage',['../group__UseMacros.html#gadcca6846ff90d436c61861db85917744',1,'clutchlog::scope_t']]], - ['style_114',['style',['../group__UseMacros.html#ga2bb0fde65fcd264393e102314dd1610b',1,'clutchlog::fmt']]] + ['stage_117',['stage',['../structclutchlog_1_1scope__t.html#adcca6846ff90d436c61861db85917744',1,'clutchlog::scope_t']]], + ['style_118',['style',['../classclutchlog_1_1fmt.html#a2bb0fde65fcd264393e102314dd1610b',1,'clutchlog::fmt']]] ]; diff --git a/docs/search/variables_6.js b/docs/search/variables_6.js index 0f51e37..50569c4 100644 --- a/docs/search/variables_6.js +++ b/docs/search/variables_6.js @@ -1,4 +1,4 @@ var searchData= [ - ['there_115',['there',['../group__UseMacros.html#ga7918e55cd3bac1bd30c69b8c711387ff',1,'clutchlog::scope_t']]] + ['there_119',['there',['../structclutchlog_1_1scope__t.html#a7918e55cd3bac1bd30c69b8c711387ff',1,'clutchlog::scope_t']]] ]; diff --git a/docs/structclutchlog_1_1scope__t-members.html b/docs/structclutchlog_1_1scope__t-members.html index 378bb74..3414da3 100644 --- a/docs/structclutchlog_1_1scope__t-members.html +++ b/docs/structclutchlog_1_1scope__t-members.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -73,10 +73,10 @@ $(function() {

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

    - - - - + + + +
    matchesclutchlog::scope_t
    scope_t()clutchlog::scope_tinline
    stageclutchlog::scope_t
    thereclutchlog::scope_t
    matchesclutchlog::scope_t
    scope_t()clutchlog::scope_tinline
    stageclutchlog::scope_t
    thereclutchlog::scope_t
    diff --git a/docs/structclutchlog_1_1scope__t.html b/docs/structclutchlog_1_1scope__t.html index 681d013..19d5154 100644 --- a/docs/structclutchlog_1_1scope__t.html +++ b/docs/structclutchlog_1_1scope__t.html @@ -22,7 +22,7 @@
    clutchlog -  0.10 +  0.11
    @@ -71,7 +71,7 @@ $(function() { Public Attributes | List of all members
    -
    clutchlog::scope_t Struct Reference
    High-level API macros
    +
    clutchlog::scope_t Struct Reference
    @@ -82,25 +82,25 @@ $(function() { - - - + + +

    Public Member Functions

    - scope_t ()
     Constructor.
     
    + scope_t ()
     Constructor.
     
    - - - - - - - - - + + + + + + + + +

    Public Attributes

    -bool matches
     Everything is compatible.
     
    -level stage
     Current log level.
     
    -bool there
     Location is compatible.
     
    +bool matches
     Everything is compatible.
     
    +level stage
     Current log level.
     
    +bool there
     Location is compatible.
     

    Detailed Description

    Structure holding a location matching.