Description:

A logger that logs all messages to the std::basic_ostream instance provided in the constructor. The name of the Logger defaults to "ANSI_LOGGER".

ALox text logger escape sequences (see class ESC) are translated to ANSI escape sequences. Support for ANSI escape sequences (also referred to as VT100 terminal emulation) is available on most unix terminal windows. Besides text colors, bold and italics font style can be set. ANSI escape sequences are also available in various IDE output windows.

Foreground and background colors can be set to be either light/dark or dark/light. This improves the readability of log output a lot and even allows to read if foreground and background colors are the same (they then still differ). However, the right setting for this is dependent on the color scheme of the final output device (window). To manipulate the right setting, see field UseLightColors and also configuration variable ALOX_CONSOLE_LIGHT_COLORS.

In the constructor, a default format string and some other definitions in member MetaInfo get set to include color settings. Of-course, these publicly accessible format attributes can be customized after creation.

Note: Instead of using ANSI sequences in the format strings directly, which would lower the run-time cost a little, ESC sequences are used because this way the light/dark color selection, which depends on the field UseLightColors is performed correctly.

There is not 100% match between the ANSI sequences and the definitions in ESC. For example ESC does not provide all ANSI colors and no blinking. On the other hand, ANSI does not allow to reset the style without resetting the colors. Of-course, it is no problem to log other ANSI codes directly into an AnsiLogger. In this case, other Loggers that might be attached to the same Lox and that do not support ANSI must be equipped with corresponding replacement information. In other words: To support the same log output into different loggers, it is recommended to use ESC sequences instead of directly using ANSI codes.

The ANSI codes used by this class are exposed through a list of fields. They might be useful for manipulating the attributes of the MetaInfo member, which of-course might contain native ANSI sequences. (In contrast to the log messages themselves, this meta information is specific to a logger instance and this way it does not need to be replaced in other loggers).

Definition at line 66 of file ansilogger.hpp.

#include <ansilogger.hpp>

Inheritance diagram for AnsiLogger:

[legend]

Collaboration diagram for AnsiLogger:

[legend]

Public Static Field Index:
static constexpr character	ANSI_BG_BLACK [6] { A_CHAR("\033[40m") }
	Select black as background color.

static constexpr character	ANSI_BG_BLUE [6] { A_CHAR("\033[44m") }
	Select blue as background color.

static constexpr character	ANSI_BG_CYAN [6] { A_CHAR("\033[46m") }
	Select cyan as background color.

static constexpr character	ANSI_BG_GRAY [12] { A_CHAR("\033[48;5;240m")}
	Select gray as background color.

static constexpr character	ANSI_BG_GREEN [6] { A_CHAR("\033[42m") }
	Select green as background color.

static constexpr character	ANSI_BG_LIGHT_BLUE [11] { A_CHAR("\033[48;5;12m") }
	Select light blue as background color.

static constexpr character	ANSI_BG_LIGHT_CYAN [11] { A_CHAR("\033[48;5;14m") }
	Select light cyan as background color.

static constexpr character	ANSI_BG_LIGHT_GRAY [12] { A_CHAR("\033[48;5;250m")}
	Select light gray as background color.

static constexpr character	ANSI_BG_LIGHT_GREEN [11] { A_CHAR("\033[48;5;10m") }
	Select light green as background color.

static constexpr character	ANSI_BG_LIGHT_MAGENTA [11] { A_CHAR("\033[48;5;13m") }
	Select light magenta as background color.

static constexpr character	ANSI_BG_LIGHT_RED [11] { A_CHAR("\033[48;5;09m") }
	Select light red as background color.

static constexpr character	ANSI_BG_LIGHT_STD_COL [6] { A_CHAR("\033[49m") }
	Select standard background color.

static constexpr character	ANSI_BG_LIGHT_YELLOW [11] { A_CHAR("\033[48;5;11m") }
	Select light yellow as background color.

static constexpr character	ANSI_BG_MAGENTA [6] { A_CHAR("\033[45m") }
	Select magenta as background color.

static constexpr character	ANSI_BG_RED [6] { A_CHAR("\033[41m") }
	Select red as background color.

static constexpr character	ANSI_BG_STD_COL [6] { A_CHAR("\033[49m") }
	Select standard background color.

static constexpr character	ANSI_BG_WHITE [11] { A_CHAR("\033[48;5;15m") }
	Select white as background color.

static constexpr character	ANSI_BG_YELLOW [6] { A_CHAR("\033[43m") }
	Select yellow as background color.

static constexpr character	ANSI_BLACK [6] { A_CHAR("\033[30m") }
	Select black as foreground color.

static constexpr character	ANSI_BLUE [6] { A_CHAR("\033[34m") }
	Select blue as foreground color.

static constexpr character	ANSI_BOLD [5] { A_CHAR("\033[1m") }
	Select bold font style.

static constexpr character	ANSI_CYAN [6] { A_CHAR("\033[36m") }
	Select cyan as foreground color.

static constexpr character	ANSI_GRAY [12] { A_CHAR("\033[38;5;240m")}
	Select gray as foreground color.

static constexpr character	ANSI_GREEN [6] { A_CHAR("\033[32m") }
	Select green as foreground color.

static constexpr character	ANSI_ITALICS [5] { A_CHAR("\033[3m") }
	Select italics font style.

static constexpr character	ANSI_LIGHT_BLUE [11] { A_CHAR("\033[38;5;12m") }
	Select light blue as foreground color.

static constexpr character	ANSI_LIGHT_CYAN [11] { A_CHAR("\033[38;5;14m") }
	Select light cyan as foreground color.

static constexpr character	ANSI_LIGHT_GRAY [12] { A_CHAR("\033[38;5;250m")}
	Select light gray as foreground color.

static constexpr character	ANSI_LIGHT_GREEN [11] { A_CHAR("\033[38;5;10m") }
	Select light green as foreground color.

static constexpr character	ANSI_LIGHT_MAGENTA [11] { A_CHAR("\033[38;5;13m") }
	Select light magenta as foreground color.

static constexpr character	ANSI_LIGHT_RED [11] { A_CHAR("\033[38;5;09m") }
	Select light red as foreground color.

static constexpr character	ANSI_LIGHT_STD_COL [6] { A_CHAR("\033[39m") }
	Select standard foreground color.

static constexpr character	ANSI_LIGHT_YELLOW [11] { A_CHAR("\033[38;5;11m") }
	Select light yellow as foreground color.

static constexpr character	ANSI_MAGENTA [6] { A_CHAR("\033[35m") }
	Select magenta as foreground color.

static constexpr character	ANSI_RED [6] { A_CHAR("\033[31m") }
	Select red as foreground color.

static constexpr character	ANSI_RESET [5] { A_CHAR("\033[0m") }
	Reset colors and font style.

static constexpr character	ANSI_STD_COL [6] { A_CHAR("\033[39m") }
	Select standard foreground color.

static constexpr character	ANSI_STD_STYLE [5] { A_CHAR("\033[0m") }
	Select standard font style.

static constexpr character	ANSI_WHITE [11] { A_CHAR("\033[38;5;15m") }
	Select white as foreground color.

static constexpr character	ANSI_YELLOW [6] { A_CHAR("\033[33m") }
	Select yellow as foreground color.

Public Static Field Index: inherited from SmartLock
static ALIB_API SmartLock	StdOutputStreams

Public Field Index:
LightColorUsage	UseLightColors

Public Field Index: inherited from TextLogger
strings::util::AutoSizes	AutoSizes

ObjectConverter *	Converter = nullptr

String16	FmtMsgSuffix

String64	FmtMultiLineMsgHeadline = A_CHAR("ALox: Multi line message follows: ")

String16	FmtMultiLinePrefix = A_CHAR(">> ")

String16	FmtMultiLineSuffix = A_CHAR("")

textlogger::MetaInfo *	MetaInfo

AString	MultiLineDelimiter

String16	MultiLineDelimiterRepl = A_CHAR("\\r")

int	MultiLineMsgMode =2

Public Field Index: inherited from Logger
integer	CntLogs =0

time::Ticks	TimeOfCreation

time::Ticks	TimeOfLastLog

Public Field Index: inherited from ThreadLock
NCString	DbgOwnerFile =nullptr

NCString	DbgOwnerFunc =nullptr

int	DbgOwnerLine

uint16_t	DbgRecursionWarningThreshold =10

integer	DbgWarningAfterWaitTimeInMillis =2000L

Public Method Index:
ALIB_API	AnsiLogger (const NString &name=nullptr, const NString &typeName="ANSI")

ALIB_API	AnsiLogger (std::ostream *pOStream, const NString &name=nullptr, const NString &typeName="ANSI")

virtual ALIB_API	~AnsiLogger () override

Public Method Index: inherited from TextLogger
virtual ALIB_API	~TextLogger () override

virtual ALIB_API void	AcknowledgeLox (LoxImpl *lox, lang::ContainerOp op) override

virtual ALIB_API void	ClearReplacements ()

virtual ALIB_API void	Log (Domain &domain, Verbosity verbosity, Boxes &logables, ScopeInfo &scope) override

virtual ALIB_API void	ResetAutoSizes ()

virtual ALIB_API void	SetReplacement (const String &searched, const String &replacement)

Public Method Index: inherited from Logger
virtual	~Logger ()

const NString &	GetName () const

const NString &	GetTypeName () const

Public Method Index: inherited from SmartLock
	SmartLock ()

void	Acquire (const NCString &dbgFile, int dbgLine, const NCString &dbgFunc)

ALIB_API int	AddAcquirer (ThreadLock *newAcquirer)

ALIB_API int	CntAcquirers ()

ALIB_API void	Release ()
	defined(ALIB_DOX)

ALIB_API int	RemoveAcquirer (ThreadLock *acquirer)

Public Method Index: inherited from ThreadLock
ALIB_API	ThreadLock (lang::Safeness safeness=lang::Safeness::Safe)

ALIB_API	~ThreadLock ()

ALIB_API void	Acquire (const NCString &dbgFile, int dbgLine, const NCString &dbgFunc)

int	CountAcquirements () const

Thread *	GetOwner () const

lang::Safeness	GetSafeness () const

bool	IsOwnedByCurrentThread () const

ALIB_API void	Release ()
	defined(ALIB_DOX)

ALIB_API void	SetSafeness (lang::Safeness safeness)

bool	WillRelease () const

Additional Inherited Members
Public Type Index: inherited from TextLogger
enum class	LightColorUsage { Auto , Never , Foreground , Background }

Field Details:

◆ ANSI_BG_BLACK

constexpr character ANSI_BG_BLACK[6] { A_CHAR("\033[40m") }

staticconstexpr

Select black as background color.

Definition at line 89 of file ansilogger.hpp.

◆ ANSI_BG_BLUE

constexpr character ANSI_BG_BLUE[6] { A_CHAR("\033[44m") }

staticconstexpr

Select blue as background color.

Definition at line 86 of file ansilogger.hpp.

◆ ANSI_BG_CYAN

constexpr character ANSI_BG_CYAN[6] { A_CHAR("\033[46m") }

staticconstexpr

Select cyan as background color.

Definition at line 88 of file ansilogger.hpp.

◆ ANSI_BG_GRAY

constexpr character ANSI_BG_GRAY[12] { A_CHAR("\033[48;5;240m")}

staticconstexpr

Select gray as background color.

Definition at line 91 of file ansilogger.hpp.

◆ ANSI_BG_GREEN

constexpr character ANSI_BG_GREEN[6] { A_CHAR("\033[42m") }

staticconstexpr

Select green as background color.

Definition at line 84 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_BLUE

constexpr character ANSI_BG_LIGHT_BLUE[11] { A_CHAR("\033[48;5;12m") }

staticconstexpr

Select light blue as background color.

Definition at line 106 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_CYAN

constexpr character ANSI_BG_LIGHT_CYAN[11] { A_CHAR("\033[48;5;14m") }

staticconstexpr

Select light cyan as background color.

Definition at line 108 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_GRAY

constexpr character ANSI_BG_LIGHT_GRAY[12] { A_CHAR("\033[48;5;250m")}

staticconstexpr

Select light gray as background color.

Definition at line 109 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_GREEN

constexpr character ANSI_BG_LIGHT_GREEN[11] { A_CHAR("\033[48;5;10m") }

staticconstexpr

Select light green as background color.

Definition at line 104 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_MAGENTA

constexpr character ANSI_BG_LIGHT_MAGENTA[11] { A_CHAR("\033[48;5;13m") }

staticconstexpr

Select light magenta as background color.

Definition at line 107 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_RED

constexpr character ANSI_BG_LIGHT_RED[11] { A_CHAR("\033[48;5;09m") }

staticconstexpr

Select light red as background color.

Definition at line 103 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_STD_COL

constexpr character ANSI_BG_LIGHT_STD_COL[6] { A_CHAR("\033[49m") }

staticconstexpr

Select standard background color.

Definition at line 110 of file ansilogger.hpp.

◆ ANSI_BG_LIGHT_YELLOW

constexpr character ANSI_BG_LIGHT_YELLOW[11] { A_CHAR("\033[48;5;11m") }

staticconstexpr

Select light yellow as background color.

Definition at line 105 of file ansilogger.hpp.

◆ ANSI_BG_MAGENTA

constexpr character ANSI_BG_MAGENTA[6] { A_CHAR("\033[45m") }

staticconstexpr

Select magenta as background color.

Definition at line 87 of file ansilogger.hpp.

◆ ANSI_BG_RED

constexpr character ANSI_BG_RED[6] { A_CHAR("\033[41m") }

staticconstexpr

Select red as background color.

Definition at line 83 of file ansilogger.hpp.

◆ ANSI_BG_STD_COL

constexpr character ANSI_BG_STD_COL[6] { A_CHAR("\033[49m") }

staticconstexpr

Select standard background color.

Definition at line 92 of file ansilogger.hpp.

◆ ANSI_BG_WHITE

constexpr character ANSI_BG_WHITE[11] { A_CHAR("\033[48;5;15m") }

staticconstexpr

Select white as background color.

Definition at line 90 of file ansilogger.hpp.

◆ ANSI_BG_YELLOW

constexpr character ANSI_BG_YELLOW[6] { A_CHAR("\033[43m") }

staticconstexpr

Select yellow as background color.

Definition at line 85 of file ansilogger.hpp.

◆ ANSI_BLACK

constexpr character ANSI_BLACK[6] { A_CHAR("\033[30m") }

staticconstexpr

Select black as foreground color.

Definition at line 78 of file ansilogger.hpp.

◆ ANSI_BLUE

constexpr character ANSI_BLUE[6] { A_CHAR("\033[34m") }

staticconstexpr

Select blue as foreground color.

Definition at line 75 of file ansilogger.hpp.

◆ ANSI_BOLD

constexpr character ANSI_BOLD[5] { A_CHAR("\033[1m") }

staticconstexpr

Select bold font style.

Definition at line 112 of file ansilogger.hpp.

◆ ANSI_CYAN

constexpr character ANSI_CYAN[6] { A_CHAR("\033[36m") }

staticconstexpr

Select cyan as foreground color.

Definition at line 77 of file ansilogger.hpp.

◆ ANSI_GRAY

constexpr character ANSI_GRAY[12] { A_CHAR("\033[38;5;240m")}

staticconstexpr

Select gray as foreground color.

Definition at line 80 of file ansilogger.hpp.

◆ ANSI_GREEN

constexpr character ANSI_GREEN[6] { A_CHAR("\033[32m") }

staticconstexpr

Select green as foreground color.

Definition at line 73 of file ansilogger.hpp.

◆ ANSI_ITALICS

constexpr character ANSI_ITALICS[5] { A_CHAR("\033[3m") }

staticconstexpr

Select italics font style.

Definition at line 113 of file ansilogger.hpp.

◆ ANSI_LIGHT_BLUE

constexpr character ANSI_LIGHT_BLUE[11] { A_CHAR("\033[38;5;12m") }

staticconstexpr

Select light blue as foreground color.

Definition at line 97 of file ansilogger.hpp.

◆ ANSI_LIGHT_CYAN

constexpr character ANSI_LIGHT_CYAN[11] { A_CHAR("\033[38;5;14m") }

staticconstexpr

Select light cyan as foreground color.

Definition at line 99 of file ansilogger.hpp.

◆ ANSI_LIGHT_GRAY

constexpr character ANSI_LIGHT_GRAY[12] { A_CHAR("\033[38;5;250m")}

staticconstexpr

Select light gray as foreground color.

Definition at line 100 of file ansilogger.hpp.

◆ ANSI_LIGHT_GREEN

constexpr character ANSI_LIGHT_GREEN[11] { A_CHAR("\033[38;5;10m") }

staticconstexpr

Select light green as foreground color.

Definition at line 95 of file ansilogger.hpp.

◆ ANSI_LIGHT_MAGENTA

constexpr character ANSI_LIGHT_MAGENTA[11] { A_CHAR("\033[38;5;13m") }

staticconstexpr

Select light magenta as foreground color.

Definition at line 98 of file ansilogger.hpp.

◆ ANSI_LIGHT_RED

constexpr character ANSI_LIGHT_RED[11] { A_CHAR("\033[38;5;09m") }

staticconstexpr

Select light red as foreground color.

Definition at line 94 of file ansilogger.hpp.

◆ ANSI_LIGHT_STD_COL

constexpr character ANSI_LIGHT_STD_COL[6] { A_CHAR("\033[39m") }

staticconstexpr

Select standard foreground color.

Definition at line 101 of file ansilogger.hpp.

◆ ANSI_LIGHT_YELLOW

constexpr character ANSI_LIGHT_YELLOW[11] { A_CHAR("\033[38;5;11m") }

staticconstexpr

Select light yellow as foreground color.

Definition at line 96 of file ansilogger.hpp.

◆ ANSI_MAGENTA

constexpr character ANSI_MAGENTA[6] { A_CHAR("\033[35m") }

staticconstexpr

Select magenta as foreground color.

Definition at line 76 of file ansilogger.hpp.

◆ ANSI_RED

constexpr character ANSI_RED[6] { A_CHAR("\033[31m") }

staticconstexpr

Select red as foreground color.

Definition at line 72 of file ansilogger.hpp.

◆ ANSI_RESET

constexpr character ANSI_RESET[5] { A_CHAR("\033[0m") }

staticconstexpr

Reset colors and font style.

Definition at line 115 of file ansilogger.hpp.

◆ ANSI_STD_COL

constexpr character ANSI_STD_COL[6] { A_CHAR("\033[39m") }

staticconstexpr

Select standard foreground color.

Definition at line 81 of file ansilogger.hpp.

◆ ANSI_STD_STYLE

constexpr character ANSI_STD_STYLE[5] { A_CHAR("\033[0m") }

staticconstexpr

Select standard font style.

Definition at line 114 of file ansilogger.hpp.

◆ ANSI_WHITE

constexpr character ANSI_WHITE[11] { A_CHAR("\033[38;5;15m") }

staticconstexpr

Select white as foreground color.

Definition at line 79 of file ansilogger.hpp.

◆ ANSI_YELLOW

constexpr character ANSI_YELLOW[6] { A_CHAR("\033[33m") }

staticconstexpr

Select yellow as foreground color.

Definition at line 74 of file ansilogger.hpp.

◆ UseLightColors

LightColorUsage UseLightColors

Foreground and background colors chosen by this class might differ in their intensity. This increases the overall readability by increasing the contrast. If the background color of a console window is dark, then the background colors of colored log output should be darker colors than the foreground colors - and vice versa.

Depending on the setting of this field, ALox escape codes for colors are translated to normal ANSI colors or lighter ones:

If this field is LightColorUsage::Never, light colors are never used.
If this field is LightColorUsage::ForegroundLight, foreground colors will be light colors and background colors dark ones. This is the default.
If LightColorUsage::ForegroundDark, background colors will be light colors and foreground colors dark ones.

The configuration variable ALOX_CONSOLE_LIGHT_COLORS allows to externally modify this flag. It is read once within the constructor.

Definition at line 151 of file ansilogger.hpp.

◆ writer

StringWriter writer

protected

Encapsulates std::cout, std::wcout or the output stream provided in the corresponding constructor.

Definition at line 125 of file ansilogger.hpp.

Constructor(s) / Destructor Details::

◆ AnsiLogger() [1/2]

AnsiLogger	(	const NString &	name = nullptr,
		const NString &	typeName = "ANSI" )

explicit

Creates an AnsiLogger using std::cout respectively std::wcout.

Parameters

name	The name of the Logger, defaults to what is provided with parameter typeName .
typeName	The type of the Logger, defaults to "ANSI".

Definition at line 40 of file ansilogger.cpp.

Here is the call graph for this function:

◆ AnsiLogger() [2/2]

AnsiLogger	(	std::ostream *	pOStream,
		const NString &	name = nullptr,
		const NString &	typeName = "ANSI" )

explicit

Creates an AnsiLogger using the given output stream.

Note: If std::cout respectively std::wcout must not be provided here. Instead, the alternative constructor omitting parameter pOStream is to be used.

Parameters

pOStream	The output stream to write into.
name	The name of the Logger, defaults to what is provided with parameter typeName .
typeName	The type of the Logger, defaults to "ANSI".

Definition at line 46 of file ansilogger.cpp.

Here is the call graph for this function:

◆ ~AnsiLogger()

~AnsiLogger ( )

overridevirtual

Destructs an AnsiLogger

Definition at line 91 of file ansilogger.cpp.

Method Details:

◆ construct()

void construct ( )

protected

The shared pared of the constructor.

Definition at line 55 of file ansilogger.cpp.

Here is the call graph for this function:

◆ logText()

void logText	(	detail::Domain &	domain,
		Verbosity	verbosity,
		AString &	msg,
		detail::ScopeInfo &	scope,
		int	lineNumber )

overrideprotectedvirtual

Implementation of the abstract method of parent class TextLogger. Logs messages to the basic output stream provided in the constructor. Replaces ALox ESC escape sequences with ANSI escape sequences.

Parameters

domain	The Log Domain.
verbosity	The verbosity. This has been checked to be active already on this stage and is provided to be able to be logged out only.
msg	The log message.
scope	Information about the scope of the Log Statement..
lineNumber	The line number of a multi-line message, starting with 0. For single line messages this is -1.

Implements TextLogger.

Definition at line 100 of file ansilogger.cpp.

Here is the call graph for this function:

◆ notifyMultiLineOp()

virtual void notifyMultiLineOp ( lang::Phase )

inlineoverrideprotectedvirtual

Empty implementation.

Implements TextLogger.

Definition at line 217 of file ansilogger.hpp.

The documentation for this class was generated from the following files:

Description:

Public Static Field Index:

Public Field Index:

Public Method Index:

Additional Inherited Members

Field Details:

◆ ANSI_BG_BLACK

◆ ANSI_BG_BLUE

◆ ANSI_BG_CYAN

◆ ANSI_BG_GRAY

◆ ANSI_BG_GREEN

◆ ANSI_BG_LIGHT_BLUE

◆ ANSI_BG_LIGHT_CYAN

◆ ANSI_BG_LIGHT_GRAY

◆ ANSI_BG_LIGHT_GREEN

◆ ANSI_BG_LIGHT_MAGENTA

◆ ANSI_BG_LIGHT_RED

◆ ANSI_BG_LIGHT_STD_COL

◆ ANSI_BG_LIGHT_YELLOW

◆ ANSI_BG_MAGENTA

◆ ANSI_BG_RED

◆ ANSI_BG_STD_COL

◆ ANSI_BG_WHITE

◆ ANSI_BG_YELLOW

◆ ANSI_BLACK

◆ ANSI_BLUE

◆ ANSI_BOLD

◆ ANSI_CYAN

◆ ANSI_GRAY

◆ ANSI_GREEN

◆ ANSI_ITALICS

◆ ANSI_LIGHT_BLUE

◆ ANSI_LIGHT_CYAN

◆ ANSI_LIGHT_GRAY

◆ ANSI_LIGHT_GREEN

◆ ANSI_LIGHT_MAGENTA

◆ ANSI_LIGHT_RED

◆ ANSI_LIGHT_STD_COL

◆ ANSI_LIGHT_YELLOW

◆ ANSI_MAGENTA

◆ ANSI_RED

◆ ANSI_RESET

◆ ANSI_STD_COL

◆ ANSI_STD_STYLE

◆ ANSI_WHITE

◆ ANSI_YELLOW

◆ UseLightColors

◆ writer

Constructor(s) / Destructor Details::

◆ AnsiLogger() [1/2]

◆ AnsiLogger() [2/2]

◆ ~AnsiLogger()

Method Details:

◆ construct()

◆ logText()

◆ notifyMultiLineOp()