ilog::ITracingConfiguration Class Reference

Interface for configuring tracing verbosity levels. More...

#include <ITracingConfiguration.h>

Inheritance diagram for ilog::ITracingConfiguration:

Public Member Functions
virtual int	GetTracingLevel () const =0
	Get the current tracing level.
virtual void	SetTracingLevel (int tracingLevel)=0
	Set the tracing level.
Public Member Functions inherited from istd::IChangeable
virtual int	GetSupportedOperations () const
	Get set of flags for supported operations.
virtual bool	CopyFrom (const IChangeable &object, CompatibilityMode mode=CM_WITHOUT_REFS)
	Copy this object from another one.
virtual bool	IsEqual (const IChangeable &object) const
	Compare this object with another object.
virtual istd::TUniqueInterfacePtr< istd::IChangeable >	CloneMe (CompatibilityMode mode=CM_WITHOUT_REFS) const
	Make a copy of this object.
virtual bool	ResetData (CompatibilityMode mode=CM_WITHOUT_REFS)
	Reset data to its default state.
virtual void	BeginChanges (const ChangeSet &changeSet)
	Starts the change transaction.
virtual void	EndChanges (const ChangeSet &changeSet)
	Ends the change transaction.
virtual void	BeginChangeGroup (const ChangeSet &changeSet)
	Starts group of changes.
virtual void	EndChangeGroup (const ChangeSet &changeSet)
	Ends group of changes.
Public Member Functions inherited from istd::IPolymorphic
virtual	~IPolymorphic ()

Additional Inherited Members
Public Types inherited from istd::IChangeable
enum	ChangeFlags {   CF_ACF_INTERNAL = 0 , CF_ALL_DATA , CF_ANY , CF_DESTROYING ,   CF_DELEGATED , CF_NO_UNDO }
	Data model change notification flags. More...
enum	SupportedOperations {   SO_NONE = 0 , SO_OBSERVE = 1 << 0 , SO_COPY = 1 << 1 , SO_CLONE = 1 << 2 ,   SO_COMPARE = 1 << 3 , SO_RESET = 1 << 4 }
	Flags for supported operations. More...
enum	CompatibilityMode { CM_STRICT , CM_WITHOUT_REFS , CM_WITH_REFS , CM_CONVERT }
	Control how relationship betweeen objects are interpreted. More...
typedef QMultiMap< QByteArray, QVariant >	ChangeInfoMap
Static Public Member Functions inherited from istd::IChangeable
static const ChangeSet &	GetNoChanges ()
	Get empty set of changes.
static const ChangeSet &	GetAnyChange ()
	Get anonymous change set.
static const ChangeSet &	GetAllChanges ()
	Get anonymous change set.
static const ChangeSet &	GetDelegatedChanges ()
	Get delegated change set.
Protected Member Functions inherited from istd::IChangeable
virtual void	OnBeginChanges ()
	Callback function for begin change event.
virtual void	OnEndChanges (const ChangeSet &changeSet)
	Callback function for end change event.

Detailed Description

Interface for configuring tracing verbosity levels.

This interface allows runtime control of diagnostic/tracing output verbosity. Higher tracing levels enable more detailed diagnostic messages, while -1 disables tracing entirely.

The tracing level is typically used in conjunction with TLoggerCompWrap's verbose message methods to control debug output granularity without recompilation.

Tracing Levels

• -1: Tracing disabled (no verbose messages)
• 0: Tracing all verbose messages (highest verbosity)
• 1+: Selective tracing (only messages with level <= current level)

Usage Example

// In component with TLoggerCompWrap
class MyComp : public ilog::CLoggerComponentBase
{
public:
    void Analyze() {
        // Level 0 - major operations
        SendVerboseMessage("Starting analysis", QString(), 0);
        
        // Level 1 - detailed steps
        if (IsVerboseEnabled(1)) {
            SendVerboseMessage("Processing chunk 1", QString(), 1);
        }
        
        // Level 2 - very detailed
        if (IsVerboseEnabled(2)) {
            SendVerboseMessage("Iteration details", QString(), 2);
        }
    }
};
 
// Configuration controls verbosity
istd::TSharedInterfacePtr<ilog::ITracingConfiguration> tracing = ...;
tracing->SetTracingLevel(1);  // Enable levels 0 and 1 only

See also

ilog::TLoggerCompWrap, ilog::CTracingConfigurationComp

Definition at line 59 of file ITracingConfiguration.h.

Member Function Documentation

GetTracingLevel()

virtual int ilog::ITracingConfiguration::GetTracingLevel ( ) const

pure virtual

Get the current tracing level.

Returns the currently configured tracing verbosity level.

Returns

Current tracing level:

• -1 = tracing disabled
• 0 = trace all verbose messages
• N = trace messages with level <= N

Example

int level = tracing->GetTracingLevel();
if (level >= 0) {
    qDebug() << "Tracing enabled at level" << level;
}
else {
    qDebug() << "Tracing disabled";
}

See also

SetTracingLevel()

Implemented in ilog::CTracingConfigurationComp.

SetTracingLevel()

virtual void ilog::ITracingConfiguration::SetTracingLevel ( int  tracingLevel )

pure virtual

Set the tracing level.

Changes the current tracing verbosity level. This affects which verbose messages will be output by components using TLoggerCompWrap.

Observers are notified of the change through the IChangeable interface.

Parameters

tracingLevel

New tracing level: -1 = disable tracing (default) 0 = enable all verbose messages N = enable messages with level <= N

Example

// Disable all tracing
tracing->SetTracingLevel(-1);
 
// Enable all tracing (maximum verbosity)
tracing->SetTracingLevel(0);
 
// Enable selective tracing (levels 0 and 1)
tracing->SetTracingLevel(1);

See also

GetTracingLevel()

Implemented in ilog::CTracingConfigurationComp.

---

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

• Acf/Include/ilog/ITracingConfiguration.h