QgsError Class Reference

A container for error messages. More...

#include <qgserror.h>

Public Member Functions
	QgsError ()=default
	QgsError (const QString &message, const QString &tag)
	Constructor with single message.
void	append (const QgsErrorMessage &message)
	Append new error message.
void	append (const QString &message, const QString &tag)
	Append new error message.
void	clear ()
	Clear error messages.
bool	isEmpty () const
	Test if no error is set.
QString	message (QgsErrorMessage::Format format=QgsErrorMessage::Html) const
	Full error messages description.
QList< QgsErrorMessage >	messageList () const
	messageList return the list of current error messages
QString	summary () const
	Short error description, usually the first error in chain, the real error.

Detailed Description

A container for error messages.

It may contain a chain (e.g. a traceback) of error messages (e.g. GDAL - provider - layer). Higher level messages are appended at the end.

Definition at line 80 of file qgserror.h.

Constructor & Destructor Documentation

QgsError() [1/2]

QgsError::QgsError ( )

default

QgsError() [2/2]

QgsError::QgsError	(	const QString &	message,
		const QString &	tag
	)

Constructor with single message.

Parameters

message	error message
tag	short description, e.g. GDAL, Provider, Layer

Definition at line 34 of file qgserror.cpp.

Member Function Documentation

append() [1/2]

void QgsError::append

(

const QgsErrorMessage &

message

)

Append new error message.

Parameters

message

error message

Definition at line 44 of file qgserror.cpp.

append() [2/2]

void QgsError::append	(	const QString &	message,
		const QString &	tag
	)

Append new error message.

Parameters

message	error message string
tag	error label, for example GDAL, GDAL Provider, Raster layer

Definition at line 39 of file qgserror.cpp.

clear()

void QgsError::clear ( )

inline

Clear error messages.

Definition at line 126 of file qgserror.h.

isEmpty()

bool QgsError::isEmpty ( ) const

inline

Test if no error is set.

Returns

false if contains error

Definition at line 110 of file qgserror.h.

message()

QString QgsError::message

(

QgsErrorMessage::Format

format = QgsErrorMessage::Html

)

const

Full error messages description.

Parameters

format

output format

Returns

error report

Definition at line 49 of file qgserror.cpp.

messageList()

QList< QgsErrorMessage > QgsError::messageList ( ) const

inline

messageList return the list of current error messages

Returns

current list of error messages

Definition at line 132 of file qgserror.h.

summary()

QString QgsError::summary

(

)

const

Short error description, usually the first error in chain, the real error.

Returns

error description

Definition at line 129 of file qgserror.cpp.

---

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

• /build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/qgserror.h
• /build/qgis-3.99.0+git20250718+f78f5286a64+99sid/src/core/qgserror.cpp