The Conroy & Conroy Subroutine Library (2021.3 edition)

TSLogger
What: class
Ancestor: TBase_Object
File: _Loggers
Layer: 0
Platforms: C++, C#, Javascript, Pascal (Delphi), PHP, Python

Defines an abstract base class for loggers. The methods are:

Log_Message
bool Log_Message( string Mess, int32 Level )
function Log_Message( Mess : string ; Level : integer ) : boolean
This procedure is called to log informational messages to the code supplying the logger. Mess is the message text, and Level indicates the type of message. If True is returned, the process should be terminated gracefully as quickly as possible.

Log_Nested_Message
bool Log_Nested_Message( string Mess, int32 Level )
function Log_Nested_Message( Mess : string ; Level : integer ) : boolean
Same as Log_Message, but the message will be followed by a Unnest_Message call when the condition causing the message goes out of scope.

Unnest_Message
bool Unnest_Message( int32 Level )
function Unnest_Message( Level : integer ) : boolean
This indicates the end of the condition under which the previous message with the specified level occurred. If True is returned, the process should be terminated gracefully as quickly as possible.

Check_Terminate
bool Check_Terminate()
function Check_Terminate : boolean
This function is called during a long process to allow for the user to abort it or for checking Windows messages, etc. If the function returns True, the process should be terminated gracefully as quickly as possible.