QSqlQuery Class

Dokumentation der Mitgliedsfunktionen

[explicit] QSqlQuery::QSqlQuery(QSqlResult *result)

Konstruiert ein QSqlQuery-Objekt, das die QSqlResult result zur Kommunikation mit einer Datenbank verwendet.

[explicit] QSqlQuery::QSqlQuery(const QSqlDatabase &db)

Konstruiert ein QSqlQuery-Objekt unter Verwendung der Datenbank db. Wenn db ungültig ist, wird die Standarddatenbank der Anwendung verwendet.

Siehe auch QSqlDatabase.

[explicit] QSqlQuery::QSqlQuery(const QString &query = QString(), const QSqlDatabase &db = QSqlDatabase())

Konstruiert ein QSqlQuery-Objekt unter Verwendung des SQL query und der Datenbank db. Wenn db nicht angegeben wird oder ungültig ist, wird die Standarddatenbank der Anwendung verwendet. Wenn query kein leerer String ist, wird er ausgeführt.

Siehe auch QSqlDatabase.

[noexcept, since 6.2] QSqlQuery::QSqlQuery(QSqlQuery &&other)

Move-konstruiert eine QSqlQuery aus other.

Diese Funktion wurde in Qt 6.2 eingeführt.

[noexcept] QSqlQuery::~QSqlQuery()

Zerstört das Objekt und gibt alle zugewiesenen Ressourcen frei.

void QSqlQuery::addBindValue(const QVariant &val, QSql::ParamType paramType = QSql::In)

Fügt den Wert val in die Liste der Werte ein, wenn positionale Wertbindung verwendet wird. Die Reihenfolge der addBindValue()-Aufrufe bestimmt, an welchen Platzhalter ein Wert in der vorbereiteten Abfrage gebunden werden soll. Wenn paramType QSql::Out oder QSql::InOut ist, wird der Platzhalter nach dem Aufruf exec() mit Daten aus der Datenbank überschrieben.

Um einen NULL-Wert zu binden, verwenden Sie eine Null QVariant; verwenden Sie beispielsweise QVariant(QMetaType::fromType<QString>()), wenn Sie eine Zeichenkette binden.

Siehe auch bindValue(), prepare(), exec(), boundValue(), und boundValues().

int QSqlQuery::at() const

Gibt die aktuelle interne Position der Abfrage zurück. Der erste Datensatz befindet sich an der Position Null. Wenn die Position ungültig ist, gibt die Funktion QSql::BeforeFirstRow oder QSql::AfterLastRow zurück, was spezielle negative Werte sind.

Siehe auch previous(), next(), first(), last(), seek(), isActive(), und isValid().

void QSqlQuery::bindValue(const QString &placeholder, const QVariant &val, QSql::ParamType paramType = QSql::In)

Legen Sie den Platzhalter placeholder fest, der in der vorbereiteten Anweisung an den Wert val gebunden werden soll. Beachten Sie, dass die Platzhaltermarkierung (z. B. :) bei der Angabe des Platzhalternamens enthalten sein muss. Wenn paramType QSql::Out oder QSql::InOut ist, wird der Platzhalter nach dem Aufruf von exec() mit Daten aus der Datenbank überschrieben. In diesem Fall muss im Voraus genügend Platz für die Speicherung des Ergebnisses reserviert werden.

Um einen NULL-Wert zu binden, verwenden Sie eine Null QVariant; verwenden Sie z.B. QVariant(QMetaType::fromType<QString>()), wenn Sie eine Zeichenkette binden wollen.

Siehe auch addBindValue(), prepare(), exec(), boundValue(), und boundValues().

void QSqlQuery::bindValue(int pos, const QVariant &val, QSql::ParamType paramType = QSql::In)

Stellen Sie den Platzhalter an der Position pos so ein, dass er an den Wert val in der vorbereiteten Anweisung gebunden ist. Die Feldnummerierung beginnt bei 0. Wenn paramType QSql::Out oder QSql::InOut ist, wird der Platzhalter nach dem Aufruf von exec() mit Daten aus der Datenbank überschrieben.

QVariant QSqlQuery::boundValue(const QString &placeholder) const

Gibt den Wert für placeholder zurück.

Siehe auch boundValues(), bindValue(), und addBindValue().

QVariant QSqlQuery::boundValue(int pos) const

Gibt den Wert für den Platzhalter an der Position pos zurück.

Siehe auch boundValues().

[since 6.6] QString QSqlQuery::boundValueName(int pos) const

Gibt den gebundenen Wert name an der Position pos zurück.

Die Reihenfolge der Liste ist die Bindungsreihenfolge, unabhängig davon, ob benannte oder positionale Bindung verwendet wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch boundValueNames().

[since 6.6] QStringList QSqlQuery::boundValueNames() const

Gibt die Namen aller gebundenen Werte zurück.

Die Reihenfolge der Liste ist die Bindungsreihenfolge, unabhängig davon, ob eine benannte oder eine positionale Bindung verwendet wird.

Diese Funktion wurde in Qt 6.6 eingeführt.

Siehe auch boundValues() und boundValueName().

[since 6.0] QVariantList QSqlQuery::boundValues() const

Gibt eine Liste von gebundenen Werten zurück.

Die Reihenfolge der Liste entspricht der Reihenfolge der Bindung, unabhängig davon, ob eine benannte oder eine positionale Bindung verwendet wird.

Die gebundenen Werte können auf die folgende Weise untersucht werden:

   const QVariantList list = query.boundValues(); for (qsizetype i = 0; i < list.size();++i)        qDebug() << i << ":" << list.at(i).toString();

Diese Funktion wurde in Qt 6.0 eingeführt.

Siehe auch boundValue(), bindValue(), addBindValue(), und boundValueNames().

void QSqlQuery::clear()

Löscht die Ergebnismenge und gibt alle von der Abfrage gehaltenen Ressourcen frei. Setzt den Abfragestatus auf inaktiv. Sie sollten diese Funktion selten, wenn überhaupt, aufrufen müssen.

const QSqlDriver *QSqlQuery::driver() const

Gibt den mit der Abfrage verbundenen Datenbanktreiber zurück.

bool QSqlQuery::exec()

Führt eine zuvor vorbereitete SQL-Abfrage aus. Gibt true zurück, wenn die Abfrage erfolgreich ausgeführt wurde; andernfalls wird false zurückgegeben.

Beachten Sie, dass der letzte Fehler für diese Abfrage zurückgesetzt wird, wenn exec() aufgerufen wird.

Siehe auch prepare(), bindValue(), addBindValue(), boundValue(), und boundValues().

bool QSqlQuery::exec(const QString &query)

Führt die SQL in query aus. Gibt true zurück und setzt den Abfragestatus auf active, wenn die Abfrage erfolgreich war; andernfalls wird false zurückgegeben. Die Zeichenfolge query muss eine für die abgefragte SQL-Datenbank geeignete Syntax verwenden (z. B. Standard-SQL).

Nach der Ausführung der Abfrage befindet sich die Abfrage auf einem ungültigen Datensatz und muss zu einem gültigen Datensatz navigiert werden, bevor Datenwerte abgerufen werden können (z. B. mit next()).

Beachten Sie, dass der letzte Fehler für diese Abfrage zurückgesetzt wird, wenn exec() aufgerufen wird.

Bei SQLite kann der Abfrage-String jeweils nur eine Anweisung enthalten. Wenn mehr als eine Anweisung angegeben wird, gibt die Funktion false zurück.

Beispiel:

    QSqlQuery query;
    query.exec("INSERT INTO employee (id, name, salary) "
               "VALUES (1001, 'Thad Beaumont', 65000)");

Siehe auch isActive(), isValid(), next(), previous(), first(), last(), und seek().

bool QSqlQuery::execBatch(QSqlQuery::BatchExecutionMode mode = ValuesAsRows)

Führt eine zuvor vorbereitete SQL-Abfrage in einem Batch aus. Alle gebundenen Parameter müssen Listen von Varianten sein. Wenn die Datenbank keine Batch-Ausführung unterstützt, simuliert der Treiber dies mit herkömmlichen exec()-Aufrufen.

Gibt true zurück, wenn die Abfrage erfolgreich ausgeführt wurde; andernfalls wird false zurückgegeben.

Beispiel:

QSqlQuery q; q.prepare("insert into myTable values (?, ?)");QVariantList ints; ints<< 1<< 2<< 3<< 4; q.addBindValue(ints);QVariantList names; names<< "Harald"<< "Boris"<< "Trond"<< QVariant(QMetaType::fromType<QString>()); q.addBindValue(names);if (!q.execBatch())    qDebug() << q.lastError();

Das obige Beispiel fügt vier neue Zeilen in myTable ein:

1  Harald
2  Boris
3  Trond
4  NULL

Um NULL-Werte zu binden, muss eine Null QVariant des entsprechenden Typs zu der gebundenen QVariantList hinzugefügt werden; zum Beispiel sollte QVariant(QMetaType::fromType<QString>()) verwendet werden, wenn Sie Strings verwenden.

Der Parameter mode gibt an, wie die gebundene QVariantList interpretiert werden soll. Wenn mode ValuesAsRows ist, wird jede Variante innerhalb von QVariantList als Wert für eine neue Zeile interpretiert. ValuesAsColumns ist ein Sonderfall für den Oracle-Treiber. In diesem Modus wird jeder Eintrag innerhalb von QVariantList als Array-Wert für einen IN- oder OUT-Wert innerhalb einer gespeicherten Prozedur interpretiert. Beachten Sie, dass dies nur funktioniert, wenn der IN- oder OUT-Wert ein Tabellentyp ist, der nur aus einer Spalte eines Basistyps besteht, zum Beispiel TYPE myType IS TABLE OF VARCHAR(64) INDEX BY BINARY_INTEGER;

Siehe auch prepare(), bindValue(), und addBindValue().

QString QSqlQuery::executedQuery() const

Gibt die letzte Abfrage zurück, die erfolgreich ausgeführt wurde.

In den meisten Fällen gibt diese Funktion die gleiche Zeichenkette zurück wie lastQuery(). Wenn eine vorbereitete Abfrage mit Platzhaltern auf einem DBMS ausgeführt wird, das diese nicht unterstützt, wird die Vorbereitung dieser Abfrage emuliert. Die Platzhalter in der ursprünglichen Abfrage werden durch ihre gebundenen Werte ersetzt, um eine neue Abfrage zu bilden. Diese Funktion gibt die geänderte Abfrage zurück. Sie ist vor allem für Debugging-Zwecke nützlich.

Siehe auch lastQuery().

void QSqlQuery::finish()

Weist den Datenbanktreiber an, dass keine weiteren Daten aus dieser Abfrage geholt werden, bis sie erneut ausgeführt wird. Normalerweise ist es nicht notwendig, diese Funktion aufzurufen, aber es kann hilfreich sein, um Ressourcen wie Sperren oder Cursor freizugeben, wenn Sie die Abfrage zu einem späteren Zeitpunkt wieder verwenden wollen.

Setzt die Abfrage auf inaktiv. Gebundene Werte behalten ihre Werte.

Siehe auch prepare(), exec(), und isActive().

bool QSqlQuery::first()

Ruft den ersten Datensatz im Ergebnis ab, falls verfügbar, und positioniert die Abfrage auf dem abgerufenen Datensatz. Beachten Sie, dass sich das Ergebnis im Zustand active befinden muss und isSelect() true zurückgeben muss, bevor Sie diese Funktion aufrufen, da sie sonst nichts tut und false zurückgibt. Gibt bei Erfolg true zurück. Wenn die Abfrage nicht erfolgreich war, wird die Position auf eine ungültige Position gesetzt und false zurückgegeben.

Siehe auch next(), previous(), last(), seek(), at(), isActive(), und isValid().

bool QSqlQuery::isActive() const

Gibt true zurück, wenn die Abfrage aktiv ist. Eine aktive QSqlQuery ist eine Abfrage, die erfolgreich exec() ausgeführt, aber noch nicht beendet wurde. Wenn Sie mit einer aktiven Abfrage fertig sind, können Sie die Abfrage inaktiv machen, indem Sie finish() oder clear() aufrufen, oder Sie können die Instanz QSqlQuery löschen.

Siehe auch isSelect().

bool QSqlQuery::isForwardOnly() const

Gibt forwardOnly zurück.

Siehe auch forwardOnly, next(), und seek().

bool QSqlQuery::isNull(int field) const

Gibt true zurück, wenn die Abfrage nicht active ist, die Abfrage nicht auf einen gültigen Datensatz positioniert ist, es keinen solchen field gibt oder field null ist; andernfalls false. Beachten Sie, dass isNull() bei einigen Treibern erst dann genaue Informationen zurückgibt, wenn ein Versuch unternommen wurde, Daten abzurufen.

Siehe auch isActive(), isValid(), und value().

bool QSqlQuery::isNull(QAnyStringView name) const

Dies ist eine überladene Funktion.

Gibt true zurück, wenn es kein Feld mit diesem name gibt; andernfalls wird isNull(int index) für den entsprechenden Feldindex zurückgegeben.

Diese Überladung ist weniger effizient als isNull()

[since 6.7] bool QSqlQuery::isPositionalBindingEnabled() const

Gibt positionalBindingEnabled zurück.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch positionalBindingEnabled.

bool QSqlQuery::isSelect() const

Gibt true zurück, wenn die aktuelle Abfrage eine SELECT -Anweisung ist; andernfalls gibt sie false zurück.

bool QSqlQuery::isValid() const

Gibt true zurück, wenn die Abfrage aktuell auf einem gültigen Datensatz positioniert ist; andernfalls wird false zurückgegeben.

bool QSqlQuery::last()

Ruft den letzten Datensatz im Ergebnis ab, sofern verfügbar, und positioniert die Abfrage auf den abgerufenen Datensatz. Beachten Sie, dass sich das Ergebnis im Zustand active befinden muss und isSelect() true zurückgeben muss, bevor Sie diese Funktion aufrufen, da sie sonst nichts tut und false zurückgibt. Gibt bei Erfolg true zurück. Wenn die Abfrage nicht erfolgreich war, wird die Position auf eine ungültige Position gesetzt und false zurückgegeben.

Siehe auch next(), previous(), first(), seek(), at(), isActive(), und isValid().

QSqlError QSqlQuery::lastError() const

Gibt Fehlerinformationen über den letzten Fehler (falls vorhanden) zurück, der bei dieser Abfrage aufgetreten ist.

Siehe auch QSqlError und QSqlDatabase::lastError().

QVariant QSqlQuery::lastInsertId() const

Gibt die Objekt-ID der zuletzt eingefügten Zeile zurück, wenn die Datenbank dies unterstützt. Eine ungültige QVariant wird zurückgegeben, wenn die Abfrage keinen Wert eingefügt hat oder wenn die Datenbank die ID nicht zurückmeldet. Wenn mehr als eine Zeile von der Einfügung betroffen war, ist das Verhalten undefiniert.

Bei MySQL-Datenbanken wird das Auto-Increment-Feld der Zeile zurückgegeben.

Siehe auch QSqlDriver::hasFeature().

QString QSqlQuery::lastQuery() const

Gibt den Text der aktuell verwendeten Abfrage zurück oder eine leere Zeichenkette, wenn es keinen aktuellen Abfragetext gibt.

Siehe auch executedQuery().

bool QSqlQuery::next()

Ruft den nächsten Datensatz im Ergebnis ab, sofern verfügbar, und positioniert die Abfrage auf den abgerufenen Datensatz. Beachten Sie, dass sich das Ergebnis im Zustand active befinden muss und isSelect() true zurückgeben muss, bevor Sie diese Funktion aufrufen, da sie sonst nichts tut und false zurückgibt.

Es gelten die folgenden Regeln:

• Befindet sich das Ergebnis derzeit vor dem ersten Datensatz, z. B. unmittelbar nach der Ausführung einer Abfrage, wird versucht, den ersten Datensatz abzurufen.
• Befindet sich das Ergebnis nach dem letzten Datensatz, gibt es keine Änderung und es wird false zurückgegeben.
• Befindet sich das Ergebnis irgendwo in der Mitte, wird versucht, den nächsten Datensatz abzurufen.

Konnte der Datensatz nicht abgerufen werden, wird das Ergebnis hinter dem letzten Datensatz positioniert und false zurückgegeben. Wenn der Datensatz erfolgreich abgerufen wurde, wird true zurückgegeben.

Siehe auch previous(), first(), last(), seek(), at(), isActive(), und isValid().

bool QSqlQuery::nextResult()

Verwirft die aktuelle Ergebnismenge und navigiert zur nächsten, falls verfügbar.

Einige Datenbanken sind in der Lage, mehrere Ergebnismengen für gespeicherte Prozeduren oder SQL-Batches (Abfrage-Strings, die mehrere Anweisungen enthalten) zurückzugeben. Wenn nach der Ausführung einer Abfrage mehrere Ergebnissätze verfügbar sind, kann diese Funktion verwendet werden, um zum nächsten Ergebnissatz bzw. zu den nächsten Ergebnissätzen zu navigieren.

Wenn ein neuer Ergebnissatz verfügbar ist, gibt diese Funktion true zurück. Die Abfrage wird auf einem ungültigen Datensatz in der neuen Ergebnismenge neu positioniert und muss zu einem gültigen Datensatz navigiert werden, bevor Datenwerte abgerufen werden können. Wenn keine neue Ergebnismenge verfügbar ist, gibt die Funktion false zurück und die Abfrage wird auf inaktiv gesetzt. In jedem Fall wird der alte Ergebnissatz verworfen.

Wenn es sich bei einer der Anweisungen um eine Nicht-Auswahl-Anweisung handelt, kann anstelle einer Ergebnismenge eine Zählung der betroffenen Zeilen verfügbar sein.

Beachten Sie, dass einige Datenbanken, z. B. Microsoft SQL Server, bei der Arbeit mit mehreren Ergebnismengen nicht blätterbare Cursor erfordern. Einige Datenbanken können alle Anweisungen auf einmal ausführen, während andere die Ausführung verzögern, bis tatsächlich auf die Ergebnismenge zugegriffen wird, und einige Datenbanken können Beschränkungen hinsichtlich der Anweisungen haben, die in einem SQL-Batch verwendet werden dürfen.

Siehe auch QSqlDriver::hasFeature(), forwardOnly, next(), isSelect(), numRowsAffected(), isActive(), und lastError().

int QSqlQuery::numRowsAffected() const

Gibt die Anzahl der Zeilen zurück, die von der SQL-Anweisung des Ergebnisses betroffen sind, oder -1, wenn sie nicht ermittelt werden kann. Beachten Sie, dass der Wert für SELECT Anweisungen undefiniert ist; verwenden Sie stattdessen size(). Wenn die Abfrage nicht active ist, wird -1 zurückgegeben.

Siehe auch size() und QSqlDriver::hasFeature().

QSql::NumericalPrecisionPolicy QSqlQuery::numericalPrecisionPolicy() const

Gibt die numericalPrecisionPolicy zurück.

Siehe auch setNumericalPrecisionPolicy().

bool QSqlQuery::prepare(const QString &query)

Bereitet die SQL-Abfrage query zur Ausführung vor. Gibt true zurück, wenn die Abfrage erfolgreich vorbereitet wurde; andernfalls wird false zurückgegeben.

Die Abfrage kann Platzhalter für Bindungswerte enthalten. Es werden sowohl Platzhalter im Oracle-Stil mit Doppelpunkt (z. B. :surname) als auch im ODBC-Stil (?) unterstützt; sie können jedoch nicht in derselben Abfrage gemischt werden. Siehe Detailed Description für Beispiele.

Hinweise zur Portabilität: Einige Datenbanken verzögern die Vorbereitung einer Abfrage, bis sie das erste Mal ausgeführt wird. In diesem Fall ist die Vorbereitung einer syntaktisch falschen Abfrage erfolgreich, aber jede nachfolgende exec() wird fehlschlagen. Wenn die Datenbank benannte Platzhalter nicht direkt unterstützt, kann der Platzhalter nur Zeichen im Bereich [a-zA-Z0-9_] enthalten.

Bei SQLite kann die Abfragezeichenfolge jeweils nur eine Anweisung enthalten. Wenn mehr als eine Anweisung angegeben wird, gibt die Funktion false zurück.

Beispiel:

    QSqlQuery query;
    query.prepare("INSERT INTO person (id, forename, surname) "
                  "VALUES (:id, :forename, :surname)");
    query.bindValue(":id", 1001);
    query.bindValue(":forename", "Bart");
    query.bindValue(":surname", "Simpson");
    query.exec();

Siehe auch exec(), bindValue(), und addBindValue().

bool QSqlQuery::previous()

Ruft den vorherigen Datensatz im Ergebnis ab, falls verfügbar, und positioniert die Abfrage auf dem abgerufenen Datensatz. Beachten Sie, dass sich das Ergebnis im Zustand active befinden muss und isSelect() true zurückgeben muss, bevor Sie diese Funktion aufrufen, da sie sonst nichts tut und false zurückgibt.

Es gelten die folgenden Regeln:

• Befindet sich das Ergebnis derzeit vor dem ersten Datensatz, gibt es keine Änderung und false wird zurückgegeben.
• Befindet sich das Ergebnis hinter dem letzten Datensatz, wird versucht, den letzten Datensatz abzurufen.
• Liegt das Ergebnis irgendwo in der Mitte, wird versucht, den vorherigen Datensatz abzurufen.

Konnte der Datensatz nicht abgerufen werden, wird das Ergebnis vor den ersten Datensatz gesetzt und false zurückgegeben. Wenn der Datensatz erfolgreich abgerufen wurde, wird true zurückgegeben.

Siehe auch next(), first(), last(), seek(), at(), isActive(), und isValid().

QSqlRecord QSqlQuery::record() const

Gibt eine QSqlRecord zurück, die die Feldinformationen für die aktuelle Abfrage enthält. Wenn die Abfrage auf eine gültige Zeile verweist (isValid() gibt true zurück), wird der Datensatz mit den Werten der Zeile aufgefüllt. Ein leerer Datensatz wird zurückgegeben, wenn es keine aktive Abfrage gibt (isActive() gibt false zurück).

Um Werte aus einer Abfrage abzurufen, sollte value() verwendet werden, da die indexbasierte Suche schneller ist.

Im folgenden Beispiel wird eine SELECT * FROM Abfrage ausgeführt. Da die Reihenfolge der Spalten nicht definiert ist, wird QSqlRecord::indexOf() verwendet, um den Index einer Spalte zu erhalten.

QSqlQuery q("select * from mitarbeiter");QSqlRecord rec = q.record();
qDebug() << "Number of columns: " << rec.count();

int nameCol = rec.indexOf("name"); // Index des Feldes "name"while (q.next())    qDebug() << q.value(nameCol).toString(); // output all names

Siehe auch value().

const QSqlResult *QSqlQuery::result() const

Gibt das mit der Abfrage verbundene Ergebnis zurück.

bool QSqlQuery::seek(int index, bool relative = false)

Ruft den Datensatz an der Position index ab, falls verfügbar, und positioniert die Abfrage auf dem abgerufenen Datensatz. Der erste Datensatz befindet sich an Position 0. Beachten Sie, dass sich die Abfrage im Zustand active befinden muss und isSelect() true zurückgeben muss, bevor Sie diese Funktion aufrufen.

Wenn relative falsch ist (die Voreinstellung), gelten die folgenden Regeln:

• Wenn index negativ ist, wird das Ergebnis vor dem ersten Datensatz positioniert und false wird zurückgegeben.
• Andernfalls wird versucht, zu dem Datensatz an der Position index zu springen. Konnte der Datensatz an der Position index nicht abgerufen werden, wird das Ergebnis hinter dem letzten Datensatz positioniert und false zurückgegeben. Wurde der Datensatz erfolgreich abgerufen, wird true zurückgegeben.

Wenn relative true ist, gelten die folgenden Regeln:

• Wenn das Ergebnis derzeit vor dem ersten Datensatz steht und:
  • index negativ oder Null ist, gibt es keine Änderung, und false wird zurückgegeben.
  • index positiv ist, wird versucht, das Ergebnis an der absoluten Position index - 1 zu positionieren, wobei dieselbe Regel wie für die nicht relative Suche (siehe oben) gilt.
• Wenn das Ergebnis derzeit hinter dem letzten Datensatz positioniert ist und:
  • index positiv oder Null ist, gibt es keine Änderung, und false wird zurückgegeben.
  • index negativ ist, wird versucht, das Ergebnis an der Position index + 1 relativ zum letzten Datensatz zu positionieren, gemäß der unten stehenden Regel.
• Befindet sich das Ergebnis derzeit irgendwo in der Mitte und der relative Versatz index verschiebt das Ergebnis unter Null, wird das Ergebnis vor dem ersten Datensatz positioniert und false zurückgegeben.
• Andernfalls wird versucht, zu dem Datensatz index zu gelangen, der vor dem aktuellen Datensatz liegt (oder index, der hinter dem aktuellen Datensatz liegt, wenn index negativ ist). Konnte der Datensatz am Offset index nicht abgerufen werden, wird das Ergebnis nach dem letzten Datensatz positioniert, wenn index >= 0 ist, (oder vor dem ersten Datensatz, wenn index negativ ist), und false wird zurückgegeben. Wenn der Datensatz erfolgreich abgerufen wurde, wird true zurückgegeben.

Siehe auch next(), previous(), first(), last(), at(), isActive(), und isValid().

void QSqlQuery::setForwardOnly(bool forward)

Setzt forwardOnly auf forward.

Siehe auch isForwardOnly(), forwardOnly, next(), und seek().

void QSqlQuery::setNumericalPrecisionPolicy(QSql::NumericalPrecisionPolicy precisionPolicy)

Setzt numericalPrecisionPolicy auf precisionPolicy.

Siehe auch numericalPrecisionPolicy().

[since 6.7] void QSqlQuery::setPositionalBindingEnabled(bool enable)

Setzt positionalBindingEnabled auf enable.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch isPositionalBindingEnabled() und positionalBindingEnabled.

int QSqlQuery::size() const

Gibt die Größe des Ergebnisses zurück (Anzahl der zurückgegebenen Zeilen) oder -1, wenn die Größe nicht ermittelt werden kann oder wenn die Datenbank keine Informationen über die Abfragegröße liefert. Beachten Sie, dass bei Anweisungen, die nichtSELECT sind (isSelect() gibt false zurück), size() -1 zurückgibt. Wenn die Abfrage nicht aktiv ist (isActive() gibt false zurück), wird -1 zurückgegeben.

Um die Anzahl der Zeilen zu ermitteln, die von einer nichtSELECT Anweisung betroffen sind, verwenden Sie numRowsAffected().

Siehe auch isActive(), numRowsAffected(), und QSqlDriver::hasFeature().

[noexcept, since 6.2] void QSqlQuery::swap(QSqlQuery &other)

Tauscht diese Abfrage mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

Diese Funktion wurde in Qt 6.2 eingeführt.

QVariant QSqlQuery::value(int index) const

Gibt den Wert des Feldes index im aktuellen Datensatz zurück.

Die Felder werden von links nach rechts nummeriert, wobei der Text der Anweisung SELECT verwendet wird, z. B. in

SELECT forename, surname FROM people;

Feld 0 ist forename und Feld 1 ist surname. Die Verwendung von SELECT * wird nicht empfohlen, da die Reihenfolge der Felder in der Abfrage undefiniert ist.

Ein ungültiges QVariant wird zurückgegeben, wenn das Feld index nicht existiert, wenn die Abfrage inaktiv ist oder wenn die Abfrage auf einem ungültigen Datensatz positioniert ist.

Siehe auch previous(), next(), first(), last(), seek(), isActive(), und isValid().

QVariant QSqlQuery::value(QAnyStringView name) const

Dies ist eine überladene Funktion.

Gibt den Wert des Feldes mit dem Namen name im aktuellen Datensatz zurück. Wenn das Feld name nicht existiert, wird eine ungültige Variante zurückgegeben.

Diese Überladung ist weniger effizient als value()

[noexcept, since 6.2] QSqlQuery &QSqlQuery::operator=(QSqlQuery &&other)

Move-weist other diesem Objekt zu.

Diese Funktion wurde in Qt 6.2 eingeführt.