QSqlRecord Class

Dokumentation zu den Member-Funktionen

QSqlRecord::QSqlRecord()

Erstellt einen leeren Datensatz.

Siehe auch isEmpty(), append() und insert().

QSqlRecord::QSqlRecord(const QSqlRecord &other)

Erstellt eine Kopie von ` other`.

QSqlRecord wird implizit gemeinsam genutzt. Das bedeutet, dass Sie Kopien eines Datensatzes in konstanter Zeit erstellen können.

[constexpr noexcept default, since 6.6] QSqlRecord::QSqlRecord(QSqlRecord &&other)

Erstellt einen neuen QSqlRecord aus „ other “ mittels Move-Konstruktion.

Diese Funktion wurde in Qt 6.6 eingeführt.

[noexcept] QSqlRecord::~QSqlRecord()

Löscht das Objekt und gibt alle zugewiesenen Ressourcen frei.

void QSqlRecord::append(const QSqlField &field)

Füge eine Kopie des Feldes „ field “ am Ende des Datensatzes an.

Siehe auch „ insert()“, „ replace()“ und „ remove()“.

void QSqlRecord::clear()

Löscht alle Felder des Datensatzes.

Siehe auch „ clearValues()“ und „ isEmpty()“.

void QSqlRecord::clearValues()

Löscht den Wert aller Felder im Datensatz und setzt jedes Feld auf „null“.

Siehe auch ` setValue()`.

bool QSqlRecord::contains(QAnyStringView name) const

Gibt „ true “ zurück, wenn der Datensatz ein Feld namens „ name “ enthält; andernfalls wird „ false “ zurückgegeben.

int QSqlRecord::count() const

Gibt die Anzahl der Felder im Datensatz zurück.

Siehe auch „ isEmpty()“.

QSqlField QSqlRecord::field(int index) const

Gibt das Feld an der Position „ index “ zurück. Liegt der Wert „ index “ außerhalb des zulässigen Bereichs, gibt die Funktion einen standardmäßig konstruierten Wert zurück.

QSqlField QSqlRecord::field(QAnyStringView name) const

Gibt das Feld „ name “ zurück. Wird das Feld „ name “ nicht gefunden, gibt die Funktion einen standardmäßig konstruierten Wert zurück.

QString QSqlRecord::fieldName(int index) const

Gibt den Namen des Feldes an der Position index zurück. Falls das Feld nicht existiert, wird eine leere Zeichenkette zurückgegeben.

Siehe auch ` indexOf()`.

int QSqlRecord::indexOf(QAnyStringView name) const

Gibt die Position des Feldes „ name “ innerhalb des Datensatzes zurück oder -1, wenn es nicht gefunden werden kann. Bei Feldnamen wird die Groß-/Kleinschreibung nicht berücksichtigt. Wenn mehrere Felder übereinstimmen, wird das erste zurückgegeben.

Siehe auch ` fieldName()`.

void QSqlRecord::insert(int pos, const QSqlField &field)

Fügt das Feld „ field “ an der Position „ pos “ in den Datensatz ein.

Siehe auch „ append()“, „ replace()“ und „ remove()“.

bool QSqlRecord::isEmpty() const

Gibt „ true “ zurück, wenn der Datensatz keine Felder enthält; andernfalls wird „ false “ zurückgegeben.

Siehe auch append(), insert() und clear().

bool QSqlRecord::isGenerated(int index) const

Gibt „ true “ zurück, wenn der Datensatz ein Feld an der Position „ index “ enthält und dieses Feld generiert werden soll (Standardeinstellung); andernfalls wird „ false “ zurückgegeben.

Siehe auch setGenerated().

bool QSqlRecord::isGenerated(QAnyStringView name) const

Gibt „ true “ zurück, wenn der Datensatz ein Feld namens „ name “ enthält und dieses Feld generiert werden soll (Standard); andernfalls wird „ false “ zurückgegeben.

Siehe auch setGenerated().

bool QSqlRecord::isNull(int index) const

Gibt „ true “ zurück, wenn das Feld „ index “ null ist oder wenn an der Position „ index “ kein Feld vorhanden ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch setNull().

bool QSqlRecord::isNull(QAnyStringView name) const

Gibt „ true “ zurück, wenn das Feld „ name “ null ist oder wenn kein Feld namens „ name “ vorhanden ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch ` setNull()`.

QSqlRecord QSqlRecord::keyValues(const QSqlRecord &keyFields) const

Gibt einen Datensatz zurück, der die in „ keyFields “ dargestellten Felder enthält, deren Werte anhand der Feldnamen zugeordnet wurden.

void QSqlRecord::remove(int pos)

Entfernt das Feld an der Position pos. Liegt pos außerhalb des zulässigen Bereichs, geschieht nichts.

Siehe auch append(), insert() und replace().

void QSqlRecord::replace(int pos, const QSqlField &field)

Ersetzt das Feld an der Position pos durch den angegebenen Wert field. Liegt pos außerhalb des zulässigen Bereichs, geschieht nichts.

Siehe auch append(), insert() und remove().

void QSqlRecord::setGenerated(QAnyStringView name, bool generated)

Setzt das generierte Flag für das Feld „ name “ auf „ generated “. Wenn das Feld nicht existiert, geschieht nichts. Nur Felder, bei denen „ generated “ auf „true“ gesetzt ist, werden in die SQL-Anweisung aufgenommen, die beispielsweise von „ QSqlQueryModel “ generiert wird.

Siehe auch isGenerated().

void QSqlRecord::setGenerated(int index, bool generated)

Setzt das generierte Flag für das Feld „ index “ auf „ generated “.

Siehe auch „ isGenerated()“.

void QSqlRecord::setNull(int index)

Setzt den Wert des Feldes „ index “ auf „null“. Wenn das Feld nicht existiert, geschieht nichts.

Siehe auch „ isNull()“ und „ setValue()“.

void QSqlRecord::setNull(QAnyStringView name)

Setzt den Wert des Feldes „ name “ auf null. Wenn das Feld nicht existiert, geschieht nichts.

void QSqlRecord::setValue(int index, const QVariant &val)

Setzt den Wert des Feldes an der Position index auf val. Falls das Feld nicht existiert, geschieht nichts.

Siehe auch value() und setNull().

void QSqlRecord::setValue(QAnyStringView name, const QVariant &val)

Setzt den Wert des Feldes „ name “ auf „ val “. Falls das Feld nicht existiert, geschieht nichts.

Siehe auch setNull().

[noexcept, since 6.6] void QSqlRecord::swap(QSqlRecord &other)

Tauscht diesen SQL-Datensatz gegen „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

Diese Funktion wurde in Qt 6.6 eingeführt.

QVariant QSqlRecord::value(int index) const

Gibt den Wert des Feldes zurück, das sich an der Position index im Datensatz befindet. Liegt index außerhalb des zulässigen Bereichs, wird ein ungültiger Wert QVariant zurückgegeben.

Siehe auch setValue(), fieldName() und isNull().

QVariant QSqlRecord::value(QAnyStringView name) const

Gibt den Wert des Feldes „ name “ im Datensatz zurück. Wenn das Feld „ name “ nicht vorhanden ist, wird eine ungültige Variante zurückgegeben.

Siehe auch indexOf() und isNull().

bool QSqlRecord::operator!=(const QSqlRecord &other) const

Gibt „ true “ zurück, wenn dieses Objekt nicht mit „ other “ identisch ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch operator==().

[noexcept, since 6.6] QSqlRecord &QSqlRecord::operator=(QSqlRecord &&other)

Weist „ other “ dieser Instanz von „ QSqlRecord “ zu.

Diese Funktion wurde in Qt 6.6 eingeführt.

QSqlRecord &QSqlRecord::operator=(const QSqlRecord &other)

Setzt den Datensatz auf den Wert „ other “.

QSqlRecord wird implizit gemeinsam genutzt. Das bedeutet, dass Sie Kopien eines Datensatzes in konstanter Zeit erstellen können.

bool QSqlRecord::operator==(const QSqlRecord &other) const

Gibt „ true “ zurück, wenn dieses Objekt mit „ other “ identisch ist (d. h., dieselben Felder in derselben Reihenfolge aufweist); andernfalls wird „ false “ zurückgegeben.

Siehe auch operator!=().