Description:

Implements the interface ObjectConverter. Class TextLogger creates an instance of this type in the moment no other (custom) type was set prior to the first log statement.

This implementation uses two specialisations of class Formatter to format the given logables to a textual representation. The formatters (and their sequence!) are:

This way, standard text logging supports format strings in Python style as well as in Java style.

Definition at line 98 of file textlogger.hpp.

#include <textlogger.hpp>

Inheritance diagram for StandardConverter:

[legend]

Collaboration diagram for StandardConverter:

[legend]

Public Field Index:
std::vector< Formatter * >	Formatters

Public Method Index:
ALIB_API	StandardConverter ()

virtual ALIB_API	~StandardConverter () override

virtual ALIB_API void	ConvertObjects (AString &target, Boxes &logables) override

virtual ALIB_API AutoSizes *	GetAutoSizes () override

virtual ALIB_API void	ResetAutoSizes () override

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

Field Details:

◆ cntRecursionx

int cntRecursionx

protected

A counter to detect recursive calls.

Definition at line 128 of file textlogger.hpp.

◆ Formatters

std::vector<Formatter*> Formatters

A list of formatters used to "convert" logables to strings. By default, each entry contains a concatenated pair of formatters of types FormatterPythonStyle and FormatterJavaStyle are added in the constructor of this class.

A vector of formatter is needed to support recursive log calls. If recursion occurs during logging (aka the conversion of a logable triggers another logging operation), necessary formatters are created on the fly, respectively re-used from previous recursions. Their settings are cloned to those of the main formatters using Formatter::CloneSettings .

The formatters created internally are set to unsafe locking mode (locking is switched-off). This is a small optimization and allowed due to the fact that class Lox is already thread-safe.

To use different formatters, it is recommended to implement a different converter type, instead of "patching" the linked and recursive formatters found in this vector.

Definition at line 123 of file textlogger.hpp.

Constructor(s) / Destructor Details::

◆ StandardConverter()

StandardConverter ( )

Constructor.

Definition at line 46 of file textlogger.cpp.

◆ ~StandardConverter()

~StandardConverter ( )

overridevirtual

Virtual destructor.

Definition at line 60 of file textlogger.cpp.

Method Details:

◆ ConvertObjects()

void ConvertObjects	(	AString &	target,
		Boxes &	logables )

overridevirtual

The conversion method. Passes target and logables to the Formatters.

Parameters

target	An AString that takes the result.
logables	The objects to convert.

Implements ObjectConverter.

Definition at line 74 of file textlogger.cpp.

◆ GetAutoSizes()

AutoSizes * GetAutoSizes ( )

overridevirtual

Checks if the first formatter in Formatters is of type FormatterPythonStyle . If so, its AutoSizes member is returned. If not, the method returns nullptr.

Returns: The auto sizes object of the main formatter.

Implements ObjectConverter.

Definition at line 114 of file textlogger.cpp.

◆ ResetAutoSizes()

void ResetAutoSizes ( )

overridevirtual

Resets automatically widened tab stops and field widths of this converter.

Implements ObjectConverter.

Definition at line 122 of file textlogger.cpp.

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

Description:

Public Field Index:

Public Method Index:

Field Details:

◆ cntRecursionx

◆ Formatters

Constructor(s) / Destructor Details::

◆ StandardConverter()

◆ ~StandardConverter()

Method Details:

◆ ConvertObjects()

◆ GetAutoSizes()

◆ ResetAutoSizes()