QSqlRecord Class

成员函数文档

QSqlRecord::QSqlRecord()

构建一个空记录。

另请参阅 isEmpty()、append() 和insert()。

QSqlRecord::QSqlRecord(const QSqlRecord &other)

创建other 的副本。

QSqlRecord 是隐式共享的。这意味着你可以以常数时间复杂度对记录进行复制。

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

从 `other` 移动并构造一个新的 `QSqlRecord`。

此函数于 Qt 6.6 中引入。

[noexcept] QSqlRecord::~QSqlRecord()

销毁该对象并释放所有已分配的资源。

void QSqlRecord::append(const QSqlField &field)

将字段field 的副本追加到记录末尾。

另请参阅 insert()、replace() 和remove()。

void QSqlRecord::clear()

删除该记录的所有字段。

另请参阅 clearValues() 和isEmpty()。

void QSqlRecord::clearValues()

清除记录中所有字段的值，并将每个字段设置为空。

另请参阅 setValue()。

bool QSqlRecord::contains(QAnyStringView name) const

如果记录中存在名为name 的字段，则返回true ；否则返回false 。

int QSqlRecord::count() const

返回记录中的字段数。

另请参阅 isEmpty()。

QSqlField QSqlRecord::field(int index) const

返回位于位置index 处的字段。如果index 超出范围，该函数将返回一个默认构造的值。

QSqlField QSqlRecord::field(QAnyStringView name) const

返回名为name 的字段。如果未找到名为name 的字段，则该函数返回一个通过默认构造函数构造的值。

QString QSqlRecord::fieldName(int index) const

返回位于位置index 处的字段名称。如果该字段不存在，则返回空字符串。

另请参阅 indexOf()。

int QSqlRecord::indexOf(QAnyStringView name) const

返回记录中名为name 的字段的位置，如果找不到则返回-1。字段名不区分大小写。如果有多个字段匹配，则返回第一个。

另请参阅 fieldName()。

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

在记录的pos 位置插入字段field 。

另请参阅 append()、replace() 和remove()。

bool QSqlRecord::isEmpty() const

如果记录中没有字段，则返回true ；否则返回false 。

另请参阅 append()、insert() 和clear()。

bool QSqlRecord::isGenerated(int index) const

如果记录在位置index 处有一个字段，且该字段需要生成（默认情况），则返回true ；否则返回false 。

另请参阅 setGenerated()。

bool QSqlRecord::isGenerated(QAnyStringView name) const

如果记录中存在名为name 的字段，且该字段需要生成（默认情况），则返回true ；否则返回false 。

另请参阅 setGenerated()。

bool QSqlRecord::isNull(int index) const

如果字段index 为空，或者位置index 处不存在该字段，则返回true ；否则返回false 。

另请参阅 setNull()。

bool QSqlRecord::isNull(QAnyStringView name) const

如果名为name 的字段为空，或者不存在名为name 的字段，则返回true ；否则返回false 。

另请参阅 setNull()。

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

返回一个记录，其中包含keyFields 中表示的字段，这些字段的值与字段名称相对应。

void QSqlRecord::remove(int pos)

删除位于位置pos 的字段。如果pos 超出范围，则不执行任何操作。

另请参阅 append()、insert() 和replace()。

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

将位置为pos 的字段替换为给定的field 。如果pos 超出范围，则不执行任何操作。

另请参阅 append()、insert() 和remove()。

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

将名为name 的字段的生成标志设置为generated 。如果该字段不存在，则不执行任何操作。例如，只有将generated 设置为true的字段才会被包含在由QSqlQueryModel 生成的SQL语句中。

另请参阅 isGenerated()。

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

将字段index 的生成标志设置为generated 。

另请参阅 isGenerated()。

void QSqlRecord::setNull(int index)

将字段index 的值设置为 null。如果该字段不存在，则不执行任何操作。

另请参阅 isNull() 和setValue()。

void QSqlRecord::setNull(QAnyStringView name)

将名为name 的字段值设为null。如果该字段不存在，则不执行任何操作。

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

将位置为index 的字段值设置为val 。如果该字段不存在，则不执行任何操作。

另请参阅 value() 和setNull()。

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

将名为name 的字段值设置为val 。如果该字段不存在，则不执行任何操作。

另请参阅 setNull()。

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

将此 SQL 记录与other 进行交换。此操作速度极快，且绝不会失败。

该函数于 Qt 6.6 中引入。

QVariant QSqlRecord::value(int index) const

返回记录中位于位置index 的字段的值。如果index 超出范围，则返回一个无效的QVariant 。

另请参阅 setValue()、fieldName() 和isNull()。

QVariant QSqlRecord::value(QAnyStringView name) const

返回记录中名为name 的字段的值。如果不存在name 字段，则返回一个无效的变体。

另请参阅 indexOf() 和isNull()。

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

如果该对象与other 不相同，则返回true ；否则返回false 。

另请参阅 operator==()。

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

将other 按移动赋值的方式赋值给此QSqlRecord 实例。

该函数在 Qt 6.6 中引入。

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

将该记录设置为other 。

QSqlRecord 该记录是隐式共享的。这意味着你可以以常数时间复杂度对记录进行复制。

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

如果该对象与other 完全相同（即具有相同的字段且顺序一致），则返回true ；否则返回false 。

另请参阅 operator!=()。