QSqlField 类

    QSqlField field("age", QMetaType::fromType<int>());
    field.setValue(QPixmap());  // WRONG

    QSqlField field("age", QMetaType::fromType<int>());
    field.setValue(QString("123"));  // casts QString to int

    QSqlQuery query;
    ...
    QSqlRecord record = query.record();
    QSqlField field = record.field("country");

成员函数文档

[显式，自6.0起] QSqlField::QSqlField(const QString &fieldName = QString(), QMetaType type = QMetaType(), const QString &table = QString())

这是一个重载函数。

在table中创建一个类型为type的空字段fieldName。

此函数自Qt 6.0引入。

参见 setRequiredStatus、setLength、setPrecision、setDefaultValue和setGenerated、setReadOnly。

QSqlField::QSqlField(const QSqlField &other)

构造other的副本。

[noexcept] QSqlField::~QSqlField()

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

void QSqlField::clear()

清除字段值并将其设置为NULL。如果字段为只读，则不执行任何操作。

参见 setValue、isReadOnly和requiredStatus。

QVariant QSqlField::defaultValue() const

返回字段的默认值（可能为NULL）。

另请参阅 setDefaultValue()，metaType()，requiredStatus()，length()，precision()，以及isGenerated()。

bool QSqlField::isAutoValue() const

如果值是由数据库自动生成的，则返回true，例如自动递增主键值。

另请参阅 setAutoValue()。

bool QSqlField::isGenerated() const

如果字段是生成的，则返回true；否则返回false。

另请参阅 setGenerated()，metaType()，requiredStatus()，length()，precision()，以及defaultValue()。

bool QSqlField::isNull() const

如果字段值为NULL，则返回true；否则返回false。

另请参阅 value()。

bool QSqlField::isReadOnly() const

如果字段值是只读的，则返回true；否则返回false。

另请参阅 setReadOnly()，metaType()，requiredStatus()，length()，precision()，以及defaultValue()。

bool QSqlField::isValid() const

如果字段的variant类型是有效的，则返回true；否则返回false。

int QSqlField::length() const

返回字段的长度。

如果返回的值是负数，则表示信息无法从数据库中获取。

另请参阅 setLength()，metaType()，requiredStatus()，precision()，defaultValue()，以及isGenerated()。

QMetaType QSqlField::metaType() const

返回存储在数据库中的字段类型。请注意，实际值可能具有不同的类型，数值太大而无法存储在long int或double中时，通常以字符串形式存储以防止精度损失。

另请参阅 setMetaType()。

QString QSqlField::name() const

返回字段的名称。

另请参阅setName().

int QSqlField::precision() const

返回字段的精度，这仅对数值类型有意义。

如果返回的值是负数，则表示信息无法从数据库中获取。

另请参阅setPrecision(), metaType(), requiredStatus(), length(), defaultValue() 和 isGenerated().

QSqlField::RequiredStatus QSqlField::requiredStatus() const

如果这是一个必填字段，则返回 true；否则返回 false。如果必填字段没有值，则 INSERT 将失败。

另请参阅setRequiredStatus(), metaType(), length(), precision(), defaultValue() 和 isGenerated().

void QSqlField::setAutoValue(bool autoVal)

如果 autoVal 为真，则将字段标记为自动生成的值。

另请参阅isAutoValue().

void QSqlField::setDefaultValue(const QVariant &value)

将此字段的默认值设置为 value。

另请参阅defaultValue(), value(), setMetaType(), setRequiredStatus(), setLength(), setPrecision(), setGenerated(), 和 setReadOnly().

void QSqlField::setGenerated(bool gen)

设置生成状态。如果 gen 为假，则不会为该字段生成 SQL；否则，Qt 类如 QSqlQueryModel 和 QSqlTableModel 将为该字段生成 SQL。

另请参阅isGenerated(), setMetaType(), setRequiredStatus(), setLength(), setPrecision(), setDefaultValue(), 和 setReadOnly().

void QSqlField::setLength(int fieldLength)

将字段的长度设置为 fieldLength。对于字符串，这是该字符串可以 hold 的最大字符数；对于其他类型，含义会变化。

另请参阅length(), setMetaType(), setRequiredStatus(), setPrecision(), setDefaultValue(), setGenerated() 和 setReadOnly().

void QSqlField::setMetaType(QMetaType type)

将字段的变体类型设置为 type。

另请参阅 metaType()、setRequiredStatus()、setLength()、setPrecision()、setDefaultValue()、setGenerated() 和 setReadOnly()。

void QSqlField::setName(const QString &name)

将字段的名称设置为 name。

另请参阅 name()。

void QSqlField::setPrecision(int precision)

设置字段的 precision。这仅影响数值字段。

另请参阅 precision()、setMetaType()、setRequiredStatus()、setLength()、setDefaultValue()、setGenerated() 和 setReadOnly()。

void QSqlField::setReadOnly(bool readOnly)

将字段值的只读标志设置为 readOnly。只读字段无法使用 setValue() 设置其值，并且无法使用 clear() 清除到 NULL。

另请参阅 isReadOnly()。

void QSqlField::setRequired(bool required)

如果 required 为 true，则将此字段的必填状态设置为 必填；否则将其设置为 可选。

另请参阅 setRequiredStatus() 和 requiredStatus()。

void QSqlField::setRequiredStatus(QSqlField::RequiredStatus required)

将此字段的必填状态设置为 required。

另请参阅 requiredStatus()、setMetaType()、setLength()、setPrecision()、setDefaultValue()、setGenerated() 和 setReadOnly()。

void QSqlField::setTableName(const QString &table)

将字段的 tableName 设置为 table。

另请参阅 tableName()。

void QSqlField::setValue(const QVariant &value)

将字段的值设置为 value。如果字段是只读的（《a href="qsqlfield.html#isReadOnly" translate="no">isReadOnly() 返回 true），则不执行任何操作。

如果 值 的数据类型与字段当前的数据类型不同，则尝试将其转换为正确类型。在赋值的情况下，这保留了字段的数据类型，例如将一个 QString 赋值为整数数据类型。

要设置值为 NULL，请使用 clear()。

另请参阅 value()，isReadOnly() 和 defaultValue()。

[自从 6.6 开始不为异常] void QSqlField::swap(QSqlField &other)

将此字段与 other 交换。此函数非常快且永远不会失败。

此功能是在 Qt 6.6 中引入的。

QString QSqlField::tableName() const

返回字段的 tableName。

另请参阅 setTableName()。

QVariant QSqlField::value() const

以 QVariant 形式返回字段值。

使用 isNull() 检查字段的值是否为 NULL。

另请参阅 setValue()。

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

如果字段不等于 other，则返回 true；否则返回 false。

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

将字段设置为等于 other。

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

如果字段等于 other，则返回 true；否则返回 false。