1/****************************************************************************
2**
3** Copyright (C) 2016 The Qt Company Ltd.
4** Contact: https://www.qt.io/licensing/
5**
6** This file is part of the QtSql module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and The Qt Company. For licensing terms
14** and conditions see https://www.qt.io/terms-conditions. For further
15** information use the contact form at https://www.qt.io/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 3 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL3 included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 3 requirements
23** will be met: https://www.gnu.org/licenses/lgpl-3.0.html.
24**
25** GNU General Public License Usage
26** Alternatively, this file may be used under the terms of the GNU
27** General Public License version 2.0 or (at your option) the GNU General
28** Public license version 3 or any later version approved by the KDE Free
29** Qt Foundation. The licenses are as published by the Free Software
30** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3
31** included in the packaging of this file. Please review the following
32** information to ensure the GNU General Public License requirements will
33** be met: https://www.gnu.org/licenses/gpl-2.0.html and
34** https://www.gnu.org/licenses/gpl-3.0.html.
35**
36** $QT_END_LICENSE$
37**
38****************************************************************************/
39
40#ifndef QSQLERROR_H
41#define QSQLERROR_H
42
43#include <QtSql/qtsqlglobal.h>
44#include <QtCore/qstring.h>
45
46QT_BEGIN_NAMESPACE
47
48class QSqlErrorPrivate;
49
50class Q_SQL_EXPORT QSqlError
51{
52public:
53 enum ErrorType {
54 NoError,
55 ConnectionError,
56 StatementError,
57 TransactionError,
58 UnknownError
59 };
60#if QT_DEPRECATED_SINCE(5, 3)
61 QT_DEPRECATED QSqlError(const QString &driverText, const QString &databaseText,
62 ErrorType type, int number);
63#endif
64 QSqlError(const QString &driverText = QString(),
65 const QString &databaseText = QString(),
66 ErrorType type = NoError,
67 const QString &errorCode = QString());
68 QSqlError(const QSqlError& other);
69 QSqlError(QSqlError &&other) noexcept : d(other.d) { other.d = nullptr; }
70 QSqlError& operator=(const QSqlError& other);
71 QSqlError &operator=(QSqlError &&other) noexcept { swap(other); return *this; }
72
73 bool operator==(const QSqlError& other) const;
74 bool operator!=(const QSqlError& other) const;
75 ~QSqlError();
76
77 void swap(QSqlError &other) noexcept { qSwap(d, other.d); }
78
79 QString driverText() const;
80 QString databaseText() const;
81 ErrorType type() const;
82#if QT_DEPRECATED_SINCE(5, 3)
83 QT_DEPRECATED int number() const;
84#endif
85 QString nativeErrorCode() const;
86 QString text() const;
87 bool isValid() const;
88
89#if QT_DEPRECATED_SINCE(5, 1)
90 QT_DEPRECATED void setDriverText(const QString &driverText);
91 QT_DEPRECATED void setDatabaseText(const QString &databaseText);
92 QT_DEPRECATED void setType(ErrorType type);
93 QT_DEPRECATED void setNumber(int number);
94#endif
95
96private:
97 // ### Qt6: Keep the pointer and remove the rest.
98 QString unused1;
99 QString unused2;
100 struct Unused {
101 ErrorType unused3;
102 int unused4;
103 };
104 union {
105 QSqlErrorPrivate *d;
106 Unused unused5;
107 };
108};
109
110Q_DECLARE_SHARED_NOT_MOVABLE_UNTIL_QT6(QSqlError)
111
112#ifndef QT_NO_DEBUG_STREAM
113Q_SQL_EXPORT QDebug operator<<(QDebug, const QSqlError &);
114#endif
115
116QT_END_NAMESPACE
117
118#endif // QSQLERROR_H
119