1// Copyright (C) 2016 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3
4#ifndef QSQLRESULT_H
5#define QSQLRESULT_H
6
7#include <QtSql/qtsqlglobal.h>
8#include <QtCore/qvariant.h>
9#include <QtCore/qcontainerfwd.h>
10
11QT_BEGIN_NAMESPACE
12
13
14class QString;
15class QSqlRecord;
16class QVariant;
17class QSqlDriver;
18class QSqlError;
19class QSqlResultPrivate;
20
21class Q_SQL_EXPORT QSqlResult
22{
23 Q_DECLARE_PRIVATE(QSqlResult)
24 friend class QSqlQuery;
25 friend class QSqlTableModelPrivate;
26
27public:
28 virtual ~QSqlResult();
29 virtual QVariant handle() const;
30
31protected:
32 enum BindingSyntax {
33 PositionalBinding,
34 NamedBinding
35 };
36
37 explicit QSqlResult(const QSqlDriver * db);
38 QSqlResult(QSqlResultPrivate &dd);
39 int at() const;
40 QString lastQuery() const;
41 QSqlError lastError() const;
42 bool isValid() const;
43 bool isActive() const;
44 bool isSelect() const;
45 bool isForwardOnly() const;
46 const QSqlDriver* driver() const;
47 virtual void setAt(int at);
48 virtual void setActive(bool a);
49 virtual void setLastError(const QSqlError& e);
50 virtual void setQuery(const QString& query);
51 virtual void setSelect(bool s);
52 virtual void setForwardOnly(bool forward);
53
54 // prepared query support
55 virtual bool exec();
56 virtual bool prepare(const QString& query);
57 virtual bool savePrepare(const QString& sqlquery);
58 virtual void bindValue(int pos, const QVariant& val, QSql::ParamType type);
59 virtual void bindValue(const QString& placeholder, const QVariant& val,
60 QSql::ParamType type);
61 void addBindValue(const QVariant& val, QSql::ParamType type);
62 QVariant boundValue(const QString& placeholder) const;
63 QVariant boundValue(int pos) const;
64 QSql::ParamType bindValueType(const QString& placeholder) const;
65 QSql::ParamType bindValueType(int pos) const;
66 int boundValueCount() const;
67#if QT_SQL_REMOVED_SINCE(6, 6)
68 QList<QVariant> &boundValues() const;
69#endif
70 QVariantList &boundValues(QT6_DECL_NEW_OVERLOAD);
71 QVariantList boundValues(QT6_DECL_NEW_OVERLOAD) const;
72
73 QString executedQuery() const;
74 QStringList boundValueNames() const;
75 QString boundValueName(int pos) const;
76 void clear();
77 bool hasOutValues() const;
78
79 BindingSyntax bindingSyntax() const;
80
81 virtual QVariant data(int i) = 0;
82 virtual bool isNull(int i) = 0;
83 virtual bool reset(const QString& sqlquery) = 0;
84 virtual bool fetch(int i) = 0;
85 virtual bool fetchNext();
86 virtual bool fetchPrevious();
87 virtual bool fetchFirst() = 0;
88 virtual bool fetchLast() = 0;
89 virtual int size() = 0;
90 virtual int numRowsAffected() = 0;
91 virtual QSqlRecord record() const;
92 virtual QVariant lastInsertId() const;
93
94 enum VirtualHookOperation { };
95 virtual void virtual_hook(int id, void *data);
96 virtual bool execBatch(bool arrayBind = false);
97 virtual void detachFromResultSet();
98 virtual void setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy policy);
99 QSql::NumericalPrecisionPolicy numericalPrecisionPolicy() const;
100 void setPositionalBindingEnabled(bool enable);
101 bool isPositionalBindingEnabled() const;
102 virtual bool nextResult();
103 void resetBindCount(); // HACK
104
105 QSqlResultPrivate *d_ptr;
106
107private:
108 Q_DISABLE_COPY(QSqlResult)
109};
110
111QT_END_NAMESPACE
112
113#endif // QSQLRESULT_H
114

source code of qtbase/src/sql/kernel/qsqlresult.h