A synchronous logger handle that directs output to a C++ standard output stream. More...

#include <ostream_logger.h>

Inheritance diagram for CppTrail::BasicSyncOstreamLogger< char_t >:

[legend]

Collaboration diagram for CppTrail::BasicSyncOstreamLogger< char_t >:

Public Member Functions
	BasicSyncOstreamLogger (std::basic_ostream< char_t > &oOstream, const bool bUseLocalTime=true)
	Constructs a logger from a raw stream reference.

	BasicSyncOstreamLogger (std::reference_wrapper< std::basic_ostream< char_t > > oOstream, const bool bUseLocalTime=true)
	Constructs a logger from a reference_wrapper.

Public Member Functions inherited from CppTrail::BasicLogger< char_t >
	BasicLogger (nullptr_t)=delete
	Prevents construction from a null pointer.

	BasicLogger (const BasicLogger &pLogger)=default
	Copy constructor (defaults to shared ownership).

	BasicLogger (BasicLogger &&pLogger)=default
	Move constructor.

BasicLogger &	operator= (const BasicLogger &pLogger)=default
	Assignment operator.

BasicLogger &	operator= (BasicLogger &&pLogger)=default
	Assignment operator.

void	start ()
	Starts the underlying logging service.

void	stop ()
	Performs a synchronous shutdown of the logger.

void	signalStop ()
	Initiates an asynchronous shutdown request.

void	join ()
	Blocks until the asynchronous shutdown sequence is complete.

Status	status ()
	Retrieves the current operational status of the logger.

BasicLogger &	log (message_type oMessage)
	Submits a pre-constructed message object to the logger.

BasicLogger &	log (const Level nLevel, string_type sMessage)
	Logs a message with a specific severity level.

BasicLogger &	log (string_type sLevel, string_type sMessage)
	Logs a message with a custom string-based level.

BasicLogger &	success (string_type sMessage)
	Submits a SUCCESS level log message.

BasicLogger &	trace (string_type sMessage)
	Submits a TRACE level log message.

BasicLogger &	debug (string_type sMessage)
	Submits a DEBUG level log message.

BasicLogger &	info (string_type sMessage)
	Submits an INFO level log message.

BasicLogger &	message (string_type sMessage)
	Submits a MESSAGE level log message.

BasicLogger &	warning (string_type sMessage)
	Submits a WARNING level log message.

BasicLogger &	error (string_type sMessage)
	Submits an ERROR level log message.

BasicLogger &	critical (string_type sMessage)
	Submits a CRITICAL level log message.

BasicLogger &	fatal (string_type sMessage)
	Submits a FATAL level log message.

BasicLogger &	success (string_view_type sMsg)
	Success wrapper for string views.

BasicLogger &	trace (string_view_type sMsg)
	Trace wrapper for string views.

BasicLogger &	debug (string_view_type sMsg)
	Debug wrapper for string views.

BasicLogger &	info (string_view_type sMsg)
	Info wrapper for string views.

BasicLogger &	message (string_view_type sMsg)
	Message wrapper for string views.

BasicLogger &	warning (string_view_type sMsg)
	Warning wrapper for string views.

BasicLogger &	error (string_view_type sMsg)
	Error wrapper for string views.

BasicLogger &	critical (string_view_type sMsg)
	Critical wrapper for string views.

BasicLogger &	fatal (string_view_type sMsg)
	Fatal wrapper for string views.

BasicLogger &	success (const char_t *sMsg)
	Success wrapper for string litterals.

BasicLogger &	trace (const char_t *sMsg)
	Trace wrapper for string litterals.

BasicLogger &	debug (const char_t *sMsg)
	Debug wrapper for string litterals.

BasicLogger &	info (const char_t *sMsg)
	Info wrapper for string litterals.

BasicLogger &	message (const char_t *sMsg)
	Message wrapper for string litterals.

BasicLogger &	warning (const char_t *sMsg)
	Warning wrapper for string litterals.

BasicLogger &	error (const char_t *sMsg)
	Error wrapper for string litterals.

BasicLogger &	critical (const char_t *sMsg)
	Critical wrapper for string litterals.

BasicLogger &	fatal (const char_t *sMsg)
	Fatal wrapper for string litterals.

BasicLogger &	log (const Level nLevel, string_view_type sMessage)
	Logs a message view with a specific severity level.

BasicLogger &	log (string_type sLevel, string_view_type sMessage)
	Logs a message view with a custom string level.

BasicLogger &	log (const Level nLevel, const char_t *sMessage)
	Logs a message view with a specific severity level.

BasicLogger &	log (string_type sLevel, const char_t *sMessage)
	Logs a message view with a custom string level.

template<typename T = char_t, typename std::enable_if< std::is_same< T, char >::value, int >::type = 0>
BasicLogger &	log (const std::exception &oException)
	Logs an exception with the default ERROR level.

template<typename T = char_t, typename std::enable_if< std::is_same< T, char >::value, int >::type = 0>
BasicLogger &	log (const Level nLevel, const std::exception &oException)
	Logs an exception with a specific severity level.

template<typename T = char_t, typename std::enable_if< std::is_same< T, char >::value, int >::type = 0>
BasicLogger &	log (string_type sLevel, const std::exception &oException)
	Logs an exception with a custom string level.

Additional Inherited Members
Public Types inherited from CppTrail::BasicLogger< char_t >
using	char_type = typename BasicLoggerImpl< char_t >::char_type
	Alias for the underlying character type used by this logger.

using	string_type = typename BasicLoggerImpl< char_t >::string_type
	Alias for the basic_string type associated with this logger's encoding.

using	message_type = typename BasicLoggerImpl< char_t >::message_type
	Alias for the BasicMessage type associated to the logger.

using	string_view_type = typename BasicLoggerImpl< char_t >::string_view_type
	Alias for the basic_string_view type associated with this logger's encoding.

Protected Member Functions inherited from CppTrail::BasicLogger< char_t >
	BasicLogger (std::shared_ptr< BasicLoggerImpl< char_t > > pLogger)
	Protected constructor for derived factories.

	~BasicLogger ()
	Destructor that ensures a graceful shutdown of the logger.

Detailed Description

template<typename char_t>
class CppTrail::BasicSyncOstreamLogger< char_t >

A synchronous logger handle that directs output to a C++ standard output stream.

This class acts as a high-level wrapper around a specialized synchronous implementation. It is ideal for console logging (std::cout/std::cerr) or simple file logging via std::ofstream.

Template Parameters

char_t The character type (e.g., char, wchar_t) used by the stream and logger.

Constructor & Destructor Documentation

◆ BasicSyncOstreamLogger() [1/2]

template<typename char_t >

CppTrail::BasicSyncOstreamLogger< char_t >::BasicSyncOstreamLogger	(	std::basic_ostream< char_t > &	oOstream,
		const bool	bUseLocalTime = `true`
	)

inline

Constructs a logger from a raw stream reference.

Parameters

oOstream	The output stream to be used for logging.
bUseLocalTime	If true, uses local time for timestamps; otherwise, uses UTC.

◆ BasicSyncOstreamLogger() [2/2]

template<typename char_t >

CppTrail::BasicSyncOstreamLogger< char_t >::BasicSyncOstreamLogger	(	std::reference_wrapper< std::basic_ostream< char_t > >	oOstream,
		const bool	bUseLocalTime = `true`
	)

inline

Constructs a logger from a reference_wrapper.

This overload allows for more flexible lifecycle management of the underlying stream.

Parameters

oOstream	A wrapper around the target output stream.
bUseLocalTime	If true, uses local time for timestamps; otherwise, uses UTC.

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

/home/runner/work/cpptrail/cpptrail/include/cpptrail/ostream_logger.h

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BasicSyncOstreamLogger() [1/2]

◆ BasicSyncOstreamLogger() [2/2]