Responsible for printing debug/warning/error messages to the console. More...

#include <qgslogger.h>

Static Public Member Functions
static void	critical (const QString &msg)
	Goes to qCritical.
static void	debug (const QString &msg, int debuglevel=1, const char file=nullptr, const char function=nullptr, int line=-1)
	Goes to qDebug.
static void	debug (const QString &var, double val, int debuglevel=1, const char file=nullptr, const char function=nullptr, int line=-1)
	Similar to the previous method, but prints a variable double-value pair.
static void	debug (const QString &var, int val, int debuglevel=1, const char file=nullptr, const char function=nullptr, int line=-1)
	Similar to the previous method, but prints a variable int-value pair.
template<typename T>
static void	debug (const QString &var, T val, const char file=nullptr, const char function=nullptr, int line=-1, int debuglevel=1)
	Prints out a variable/value pair for types with overloaded operator<<.
static int	debugLevel ()
	Reads the environment variable QGIS_DEBUG and converts it to int.
static void	fatal (const QString &msg)
	Goes to qFatal.
static QString	logFile ()
	Reads the environment variable QGIS_LOG_FILE.
static void	logMessageToFile (const QString &message)
	Logs the message passed in to the logfile defined in QGIS_LOG_FILE if any.
static void	warning (const QString &msg)
	Goes to qWarning.

Detailed Description

Responsible for printing debug/warning/error messages to the console.

The advantage of this class over iostream & co. is that the output can be controlled with environment variables: QGIS_DEBUG is an int describing what debug messages are written to the console. If the debug level of a message is <= QGIS_DEBUG, the message is written to the console. It the variable QGIS_DEBUG is not defined, it defaults to 1 for debug mode and to 0 for release mode QGIS_DEBUG_FILE may contain a file name. Only the messages from this file are printed (provided they have the right debuglevel). If QGIS_DEBUG_FILE is not set, messages from all files are printed

QGIS_LOG_FILE may contain a file name. If set, all messages will be appended to this file rather than to stdout.

Definition at line 98 of file qgslogger.h.

Member Function Documentation

◆ critical()

void QgsLogger::critical ( const QString & msg )

static

Goes to qCritical.

Definition at line 140 of file qgslogger.cpp.

◆ debug() [1/4]

void QgsLogger::debug	(	const QString &	msg,
		int	debuglevel = 1,
		const char *	file = nullptr,
		const char *	function = nullptr,
		int	line = -1 )

static

Goes to qDebug.

Parameters

msg	the message to be printed
debuglevel
file	file name where the message comes from
function	function where the message comes from
line	place in file where the message comes from

Definition at line 62 of file qgslogger.cpp.

◆ debug() [2/4]

void QgsLogger::debug	(	const QString &	var,
		double	val,
		int	debuglevel = 1,
		const char *	file = nullptr,
		const char *	function = nullptr,
		int	line = -1 )

static

Similar to the previous method, but prints a variable double-value pair.

Note: not available in Python bindings

Definition at line 129 of file qgslogger.cpp.

◆ debug() [3/4]

void QgsLogger::debug	(	const QString &	var,
		int	val,
		int	debuglevel = 1,
		const char *	file = nullptr,
		const char *	function = nullptr,
		int	line = -1 )

static

Similar to the previous method, but prints a variable int-value pair.

Definition at line 124 of file qgslogger.cpp.

◆ debug() [4/4]

template<typename T>

void QgsLogger::debug	(	const QString &	var,
		T	val,
		const char *	file = nullptr,
		const char *	function = nullptr,
		int	line = -1,
		int	debuglevel = 1 )

inlinestatic

Prints out a variable/value pair for types with overloaded operator<<.

Note: not available in Python bindings

Definition at line 125 of file qgslogger.h.

◆ debugLevel()

int QgsLogger::debugLevel ( )

inlinestatic

Reads the environment variable QGIS_DEBUG and converts it to int.

If QGIS_DEBUG is not set, the function returns 1 if QGISDEBUG is defined and 0 if not.

Definition at line 146 of file qgslogger.h.

◆ fatal()

void QgsLogger::fatal ( const QString & msg )

static

Goes to qFatal.

Definition at line 146 of file qgslogger.cpp.

◆ logFile()

QString QgsLogger::logFile ( )

static

Reads the environment variable QGIS_LOG_FILE.

Returns an empty string if the variable is not set, otherwise returns a file name for writing log messages to.

Calling this method initializes the logging system by reading the environment variables QGIS_LOG_FILE, QGIS_DEBUG, and QGIS_DEBUG_FILE.

This method must be called before any call to logMessageToFile(), otherwise messages will not be written to the log file.

Returns the log file path used by QgsLogger.

Definition at line 166 of file qgslogger.cpp.

◆ logMessageToFile()

void QgsLogger::logMessageToFile ( const QString & message )

static

Logs the message passed in to the logfile defined in QGIS_LOG_FILE if any.

Definition at line 152 of file qgslogger.cpp.

◆ warning()

void QgsLogger::warning ( const QString & msg )

static

Goes to qWarning.

Definition at line 134 of file qgslogger.cpp.

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

/build/qgis-3.99.0+git20260209+8e76e220402+99sid/src/core/qgslogger.h
/build/qgis-3.99.0+git20260209+8e76e220402+99sid/src/core/qgslogger.cpp

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ critical()

◆ debug() [1/4]

◆ debug() [2/4]

◆ debug() [3/4]

◆ debug() [4/4]

◆ debugLevel()

◆ fatal()

◆ logFile()

◆ logMessageToFile()

◆ warning()