QGIS API Documentation
3.40.0-Bratislava (b56115d8743)
Loading...
Searching...
No Matches
src
core
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
32
class
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
80
class
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
QgsErrorMessage represents single error message.
Definition
qgserror.h:33
QgsErrorMessage::tag
QString tag() const
Definition
qgserror.h:55
QgsErrorMessage::file
QString file() const
Definition
qgserror.h:56
QgsErrorMessage::function
QString function() const
Definition
qgserror.h:57
QgsErrorMessage::line
int line() const
Definition
qgserror.h:58
QgsErrorMessage::QgsErrorMessage
QgsErrorMessage()=default
QgsErrorMessage::Format
Format
Format.
Definition
qgserror.h:37
QgsErrorMessage::Html
@ Html
Definition
qgserror.h:39
QgsErrorMessage::Text
@ Text
Definition
qgserror.h:38
QgsErrorMessage::message
QString message() const
Definition
qgserror.h:54
QgsError
A container for error messages.
Definition
qgserror.h:81
QgsError::clear
void clear()
Clear error messages.
Definition
qgserror.h:126
QgsError::isEmpty
bool isEmpty() const
Test if any error is set.
Definition
qgserror.h:110
QgsError::QgsError
QgsError()=default
QgsError::messageList
QList< QgsErrorMessage > messageList() const
messageList return the list of current error messages
Definition
qgserror.h:132
str
#define str(x)
Definition
qgis.cpp:38
Generated on Mon Oct 28 2024 22:06:03 for QGIS API Documentation by
1.9.8