Qt 4.8
qsql_sqlite.h
Go to the documentation of this file.
1 /****************************************************************************
2 **
3 ** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4 ** Contact: http://www.qt-project.org/legal
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 Digia. For licensing terms and
14 ** conditions see http://qt.digia.com/licensing. For further information
15 ** use the contact form at http://qt.digia.com/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 2.1 as published by the Free Software
20 ** Foundation and appearing in the file LICENSE.LGPL included in the
21 ** packaging of this file. Please review the following information to
22 ** ensure the GNU Lesser General Public License version 2.1 requirements
23 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 **
25 ** In addition, as a special exception, Digia gives you certain additional
26 ** rights. These rights are described in the Digia Qt LGPL Exception
27 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 **
29 ** GNU General Public License Usage
30 ** Alternatively, this file may be used under the terms of the GNU
31 ** General Public License version 3.0 as published by the Free Software
32 ** Foundation and appearing in the file LICENSE.GPL included in the
33 ** packaging of this file. Please review the following information to
34 ** ensure the GNU General Public License version 3.0 requirements will be
35 ** met: http://www.gnu.org/copyleft/gpl.html.
36 **
37 **
38 ** $QT_END_LICENSE$
39 **
40 ****************************************************************************/
41 
42 #ifndef QSQL_SQLITE_H
43 #define QSQL_SQLITE_H
44 
45 #include <QtSql/qsqldriver.h>
46 #include <QtSql/qsqlresult.h>
47 #include <QtSql/private/qsqlcachedresult_p.h>
48 
49 struct sqlite3;
50 
51 #ifdef QT_PLUGIN
52 #define Q_EXPORT_SQLDRIVER_SQLITE
53 #else
54 #define Q_EXPORT_SQLDRIVER_SQLITE Q_SQL_EXPORT
55 #endif
56 
58 
62 class QSQLiteDriver;
63 
65 {
66  friend class QSQLiteDriver;
67  friend class QSQLiteResultPrivate;
68 public:
69  explicit QSQLiteResult(const QSQLiteDriver* db);
71  QVariant handle() const;
72 
73 protected:
74  bool gotoNext(QSqlCachedResult::ValueCache& row, int idx);
75  bool reset(const QString &query);
76  bool prepare(const QString &query);
77  bool exec();
78  int size();
79  int numRowsAffected();
80  QVariant lastInsertId() const;
81  QSqlRecord record() const;
82  void virtual_hook(int id, void *data);
83 
84 private:
86 };
87 
89 {
90  Q_OBJECT
91  friend class QSQLiteResult;
92 public:
93  explicit QSQLiteDriver(QObject *parent = 0);
94  explicit QSQLiteDriver(sqlite3 *connection, QObject *parent = 0);
95  ~QSQLiteDriver();
96  bool hasFeature(DriverFeature f) const;
97  bool open(const QString & db,
98  const QString & user,
99  const QString & password,
100  const QString & host,
101  int port,
102  const QString & connOpts);
103  void close();
104  QSqlResult *createResult() const;
105  bool beginTransaction();
106  bool commitTransaction();
107  bool rollbackTransaction();
108  QStringList tables(QSql::TableType) const;
109 
110  QSqlRecord record(const QString& tablename) const;
111  QSqlIndex primaryIndex(const QString &table) const;
112  QVariant handle() const;
113  QString escapeIdentifier(const QString &identifier, IdentifierType) const;
114 
115 private:
117 };
118 
120 
122 
123 #endif // QSQL_SQLITE_H
The QVariant class acts like a union for the most common Qt data types.
Definition: qvariant.h:92
The QSqlIndex class provides functions to manipulate and describe database indexes.
Definition: qsqlindex.h:55
QVariant data(int i)
Returns the data for field index in the current row as a QVariant.
QVariant lastInsertId() const
Returns the object ID of the most recent inserted row if the database supports it.
#define QT_END_NAMESPACE
This macro expands to.
Definition: qglobal.h:90
QVariant handle() const
Returns the low-level database handle for this result set wrapped in a QVariant or an invalid QVarian...
DriverFeature
This enum contains a list of features a driver might support.
Definition: qsqldriver.h:75
#define QT_BEGIN_HEADER
Definition: qglobal.h:136
QSQLiteDriverPrivate * d
Definition: qsql_sqlite.h:116
The QSqlRecord class encapsulates a database record.
Definition: qsqlrecord.h:58
The QSqlDriver class is an abstract base class for accessing specific SQL databases.
Definition: qsqldriver.h:68
The QString class provides a Unicode character string.
Definition: qstring.h:83
The QObject class is the base class of all Qt objects.
Definition: qobject.h:111
#define QT_BEGIN_NAMESPACE
This macro expands to.
Definition: qglobal.h:89
The QStringList class provides a list of strings.
Definition: qstringlist.h:66
TableType
Definition: qsql.h:74
#define Q_EXPORT_SQLDRIVER_SQLITE
Definition: qsql_sqlite.h:54
bool gotoNext(QSqlCachedResult::ValueCache &row, int idx)
bool prepare(const QString &query)
Prepares the given query for execution; the query will normally use placeholders so that it can be ex...
QSQLiteResult(const QSQLiteDriver *db)
friend class QSQLiteDriver
Definition: qsql_sqlite.h:66
#define Q_OBJECT
Definition: qobjectdefs.h:157
bool reset(const QString &query)
Sets the result to use the SQL statement query for subsequent data retrieval.
static bool hasFeature(const QDockWidgetPrivate *priv, QDockWidget::DockWidgetFeature feature)
Definition: qdockwidget.cpp:74
int size()
Returns the size of the SELECT result, or -1 if it cannot be determined or if the query is not a SELE...
QSQLiteResultPrivate * d
Definition: qsql_sqlite.h:85
QSqlRecord record() const
Returns the current record if the query is active; otherwise returns an empty QSqlRecord.
bool exec()
Executes the query, returning true if successful; otherwise returns false.
void virtual_hook(int id, void *data)
#define QT_END_HEADER
Definition: qglobal.h:137
The QSqlResult class provides an abstract interface for accessing data from specific SQL databases...
Definition: qsqlresult.h:63
IdentifierType
This enum contains a list of SQL identifier types.
Definition: qsqldriver.h:83
int numRowsAffected()
Returns the number of rows affected by the last query executed, or -1 if it cannot be determined or i...
int open(const char *, int,...)