ALib C++ Library
Library Version: 2510 R0
Documentation generated by doxygen
Loading...
Searching...
No Matches
alib::lox::textlogger::FormatMultiLine Struct Reference

Description:

Definition of the multi-line message mode for class textlogger::TextLogger and its derivates. This struct is used to define an external configuration variable named ALOX/LOGGERNAME/FORMAT_MULTILINE. This variable can be accessed programatically with TextLogger::GetFormatMultiLine or by accessing the variable's value through the configuration object found in camp singleton alib::ALOX.

Definition at line 196 of file variables.inl.

Collaboration diagram for alib::lox::textlogger::FormatMultiLine:
[legend]

Public Field Index:

AStringPA Delimiter
 
AStringPA DelimiterReplacement
 
AStringPA Headline
 
int Mode
 
AStringPA Prefix
 
AStringPA Suffix
 

Public Method Index:

 FormatMultiLine (PoolAllocator &pool)
 

Field Details:

◆ Delimiter

AStringPA alib::lox::textlogger::FormatMultiLine::Delimiter

This is the string interpreted as line delimiter within log messages. If nulled, then '\n', '\r' or '\r\n' is recognized.
Important: Can be set to an empty string, to stop any multi line processing of TextLogger, even the replacements of the delimiter character.

Definition at line 223 of file variables.inl.

◆ DelimiterReplacement

AStringPA alib::lox::textlogger::FormatMultiLine::DelimiterReplacement

This is the readable (!) separator string, for logging out multi line messages into a single line (Mode==0). Defaults to "\\r".

Definition at line 245 of file variables.inl.

◆ Headline

AStringPA alib::lox::textlogger::FormatMultiLine::Headline

Headline for multi line messages (depending on Mode) . Defaults to "ALox: Multi line message follows: "

Definition at line 227 of file variables.inl.

◆ Mode

int alib::lox::textlogger::FormatMultiLine::Mode

Determines if multi line messages should be split into different log lines. Possible values are:

  • 0: No line split is performed, delimiters can be replaced by readable delimiters (depending on setting of Delimiter and DelimiterReplacement).
  • 1: Each log line contains all meta-information
  • 2: Starting with second log line, meta-information is replaced by blanks (default)
  • 3: The headline Headline is logged and all lines of the multi line text are logged at position zero (without further meta-information)
  • 4: Just the multi line text is logged, starting at column zero (no meta-information is logged)
Note
In modes 3 and 4, no ESC::EOMETA is included at the beginning of the message. Loggers that need such info, have to implement method TextLogger::notifyMultiLineOp.

Definition at line 217 of file variables.inl.

◆ Prefix

AStringPA alib::lox::textlogger::FormatMultiLine::Prefix

Prefix for multi line messages. This is also used if multi line messages logging is switched off (MultiLineMsgMode == 0) but replacing of a set MultiLineDelimiter takes place. Defaults to ">> ".

Definition at line 233 of file variables.inl.

◆ Suffix

AStringPA alib::lox::textlogger::FormatMultiLine::Suffix

Suffix for multi line messages. This is also used if multi line messages logging is switched off (MultiLineMsgMode == 0) and replacing of a set Delimiter takes place.
Note that at the end of the last line, in addition Suffix is added.
Defaults to "".

Definition at line 240 of file variables.inl.

Constructor(s) / Destructor Details:

◆ FormatMultiLine()

alib::lox::textlogger::FormatMultiLine::FormatMultiLine ( PoolAllocator & pool)
inline

Constructor taking an object pool which is passed to each string member.

Parameters
poolThe pool object of the Configuration.

Definition at line 249 of file variables.inl.


The documentation for this struct was generated from the following file: