QGIS API Documentation 3.40.0-Bratislava (b56115d8743)
Loading...
Searching...
No Matches
qgserror.h
Go to the documentation of this file.
1/***************************************************************************
2 qgserror.h - Error container
3 -------------------
4 begin : October 2012
5 copyright : (C) 2012 Radim Blazek
6 email : radim dot blazek at gmail dot com
7 ***************************************************************************/
8
9/***************************************************************************
10 * *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
15 * *
16 ***************************************************************************/
17#ifndef QGSERROR_H
18#define QGSERROR_H
19
20#include <QString>
21#include <QList>
22
23#include "qgis_core.h"
24
25// Macro to create Error message including info about where it was created.
26#define QGS_ERROR_MESSAGE(message, tag) QgsErrorMessage(QString(message),QString(tag), QString(__FILE__), QString(__FUNCTION__), __LINE__)
27
32class CORE_EXPORT QgsErrorMessage
33{
34 public:
36 enum Format
37 {
38 Text, // Plain text
39 Html
40 };
41
42 QgsErrorMessage() = default;
43
52 QgsErrorMessage( const QString &message, const QString &tag = QString(), const QString &file = QString(), const QString &function = QString(), int line = 0 );
53
54 QString message() const { return mMessage; }
55 QString tag() const { return mTag; }
56 QString file() const { return mFile; }
57 QString function() const { return mFunction; }
58 int line() const { return mLine; }
59
60 private:
62 QString mMessage;
63
65 QString mTag;
66
68 QString mFile;
69 QString mFunction;
70 int mLine = 0;
71};
72
80class CORE_EXPORT QgsError
81{
82 public:
83
84 QgsError() = default;
85
91 QgsError( const QString &message, const QString &tag );
92
98 void append( const QString &message, const QString &tag );
99
104 void append( const QgsErrorMessage &message );
105
110 bool isEmpty() const { return mMessageList.isEmpty(); }
111
117 QString message( QgsErrorMessage::Format format = QgsErrorMessage::Html ) const;
118
123 QString summary() const;
124
126 void clear() { mMessageList.clear(); }
127
132 QList<QgsErrorMessage> messageList() const { return mMessageList; }
133
134
135#ifdef SIP_RUN
136 SIP_PYOBJECT __repr__();
137 % MethodCode
138 QString str = QStringLiteral( "<QgsError: %1>" ).arg( sipCpp->message( QgsErrorMessage::Text ) );
139 sipRes = PyUnicode_FromString( str.toUtf8().constData() );
140 % End
141#endif
142
143 private:
145 QList<QgsErrorMessage> mMessageList;
146};
147
148#endif
QgsErrorMessage represents single error message.
Definition qgserror.h:33
QString tag() const
Definition qgserror.h:55
QString file() const
Definition qgserror.h:56
QString function() const
Definition qgserror.h:57
int line() const
Definition qgserror.h:58
QgsErrorMessage()=default
Format
Format.
Definition qgserror.h:37
QString message() const
Definition qgserror.h:54
A container for error messages.
Definition qgserror.h:81
void clear()
Clear error messages.
Definition qgserror.h:126
bool isEmpty() const
Test if any error is set.
Definition qgserror.h:110
QgsError()=default
QList< QgsErrorMessage > messageList() const
messageList return the list of current error messages
Definition qgserror.h:132
#define str(x)
Definition qgis.cpp:38