QVariant类

成员函数文档

返回存储在变元中的值的存储类型。这与 metaType().id() 相同。

另请参阅 metaType().

返回对包含对象的指针，以通用的 void* 形式，无法写入。

另请参阅 get_if() 和 QMetaType.

[noexcept] QVariant::QVariant()

构造一个无效的变元。

[explicit] QVariant::QVariant(QMetaType type, const void *copy = nullptr)

构造一个类型为 type 的变元，并在不是 nullptr 时用副本初始化 *copy（在这种情况下，copy 必须指向类型为 type 的对象）。

注意，您必须传递要存储的对象的地址。

通常，您不需要使用此构造函数，而是使用 QVariant::fromValue() 来从由 QMetaType::VoidStar 和 QMetaType::QObjectStar 表示的指针类型构造变元。

如果 type 不支持复制构造，并且 copy 不是 nullptr，则变元将为无效。同样，如果 copy 是 nullptr 且 type 不支持默认构造，则变元将为无效。

另请参阅 QVariant::fromMetaType、QVariant::fromValue() 和 QMetaType::Type.

[noexcept(...)] QVariant::QVariant(QLineF val)

使用 val 的行值构造新的变元。

[noexcept(...)] QVariant::QVariant(QRect val)

使用 val 的矩形值构造新的变元。

[noexcept(...)] QVariant::QVariant(QRectF val)

使用 val 的矩形值构造新的变元。

QVariant::QVariant(const QEasingCurve &val)

使用缓动曲线值，val，构造新的变元。

QVariant::QVariant(const QJsonDocument &val)

使用 json 文档值，val，构造一个新的变体。

QVariant::QVariant(const QPersistentModelIndex &val)

使用 QPersistentModelIndex 值，val，构造一个新的变体。

QVariant::QVariant(const char *val)

使用字符串值 val 构造一个新的变体。该变体会将 val 深拷贝到一个 QString 中，假设输入 val 使用 UTF-8 编码。

注意，val 被转换为 QString 以存储在变体中，并且 QVariant::userType() 将为变体返回 QMetaType::QString。

您可以通过在编译应用程序时定义 QT_NO_CAST_FROM_ASCII 来禁用此操作符。

QVariant::QVariant(QLatin1StringView val)

从由 val 观看的 Latin-1 字符串中构造一个新的变体，其值为 QString。

[显式 noexcept(...), 自 6.6 版起] 模板 <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, Args &&... args)

构造一个新的变体，包含类型为 T 的值。包含的值使用 std::forward<Args>(args)... 的参数进行初始化。

此重载仅在 T 可以从 args 构造时参与重载解析。

此构造函数提供了 STL/std::any 兼容性。

这是一个重载函数。

此函数是在 Qt 6.6 中引入的。

[显式 noexcept(...), 自 6.6 版起] 模板 <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args &&... args)

这是一个重载函数。

此重载存在是为了支持接收 initializer_list 构造函数的类型。它在其他方面与非初始化列表 in_place_type_t 重载等效。

此函数是在 Qt 6.6 中引入的。

[noexcept] QVariant::QVariant(int val)

使用整数值，val，构造一个新的变体。

[noexcept] QVariant::QVariant(uint val)

使用无符号整数值，val，构造一个新的变体。

[noexcept] QVariant::QVariant(qlonglong val)

使用长长整数值，val，构造一个新的变体。

[noexcept] QVariant::QVariant(qulonglong val)

使用无符号长长整数值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(bool val)

使用布尔值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(double val)

使用浮点值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(float val)

使用浮点值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(QChar c)

使用字符值 c 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QDate &val)

使用日期值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QTime &val)

使用时间值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QBitArray &val)

使用位数组值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QByteArray &val)

使用字节数组值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QDateTime &val)

使用日期时间值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QHash<QString, QVariant> &val)

使用 QVariant 哈希 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QJsonArray &val)

使用 JSON 数组值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QJsonObject &val)

使用 JSON 对象值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QList<QVariant> &val)

使用列表值 val 构建一个新的 variant 对象。

[noexcept] QVariant::QVariant(const QLocale &l)

使用地区值 l 构造一个新的变体。

[noexcept] QVariant::QVariant(const QMap<QString, QVariant> &val)

使用 QVariant 映射 val 构造一个新的变体。

[noexcept] QVariant::QVariant(const QRegularExpression &re)

使用正则表达式值 re 构造一个新的变体。

[noexcept] QVariant::QVariant(const QString &val)

使用字符串值 val 构造一个新的变体。

[noexcept] QVariant::QVariant(const QStringList &val)

使用字符串列表值 val 构造一个新的变体。

[noexcept] QVariant::QVariant(const QUrl &val)

使用 URL 值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(const QJsonValue &val)

使用 JSON 值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(const QModelIndex &val)

使用 QModelIndex 值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(QUuid val)

使用 uuid 值 val 构造一个新的变体。

[noexcept] QVariant::QVariant(QSize val)

使用大小值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(QSizeF val)

使用大小值 val 构造一个新的变体。

[noexcept] QVariant::QVariant(QPoint val)

使用点值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(QPointF val)

使用点值 val 构造一个新的变体。

[noexcept(...)] QVariant::QVariant(QLine val)

使用 val 的行值构造新的变元。

QVariant::QVariant(const QVariant &p)

构造一个变体的副本，将作为构造函数参数传递的 p。

[noexcept] QVariant::QVariant(QVariant &&other)

移动构造一个 QVariant 实例，使其指向 other 指向的对象。

[noexcept] QVariant::~QVariant()

销毁 QVariant 及其内部对象。

[since 6.0] bool QVariant::canConvert(QMetaType type) const

如果变体的类型可以转换为目标类型 type，则返回 true。在调用 toInt()，toBool()，... 等方法时，此类转换会自动进行。

此函数是在 Qt 6.0 中引入的。

另请参阅 QMetaType::canConvert().

template <typename T> bool QVariant::canConvert() const

如果变体可以转换为模板类型 T，则返回 true，否则返回 false。

示例

QVariant v = 42;

v.canConvert<int>();              // returns true
v.canConvert<QString>();          // returns true

MyCustomStruct s;
v.setValue(s);

v.canConvert<int>();              // returns false
v.canConvert<MyCustomStruct>();   // returns true

包含指向从 QObject 派生类型的指针的 QVariant，如果将指针 qobject_cast 到模板类型 T 会成功，则此函数也会返回 true。请注意，这只适用于使用 Q_OBJECT 宏的 QObject 子类。

另请参阅 convert().

template <typename T> bool QVariant::canView() const

如果可以在该变体上创建模板类型 T 的可变视图，则返回 true，否则返回 false。

另请参阅 value().

void QVariant::clear()

将此变体转换为类型 QMetaType::UnknownType 并释放所使用的资源。

[static, since 6.0] QPartialOrdering QVariant::compare(const QVariant &lhs, const QVariant &rhs)

比较 lhs 和 rhs 中的对象，以进行排序。

如果比较不受支持或值未排序，则返回 QPartialOrdering::Unordered。否则，如果 lhs 分别小于、等于或大于 rhs，则返回 QPartialOrdering::Less、QPartialOrdering::Equivalent 或 QPartialOrdering::Greater。

如果变体的数据具有不同的元类型，除非它们都是数值或指针类型，否则值被视为未排序，在这种情况下将使用常规的数值或指针比较规则。

如果两个变体包含相同元类型的数据，该方法将使用 QMetaType::compare 方法确定两个变体之间的排序，这也可以表示无法在这两个值之间建立排序。

此函数是在 Qt 6.0 中引入的。

另请参阅：QMetaType::compare() 和 QMetaType::isOrdered。

[since 6.0] bool QVariant::convert(QMetaType targetType)

将变体转换为请求的类型 targetType。如果无法转换，变体将仍然转换为请求的类型，但会变为清除的空状态，类似于由 QVariant(Type) 构造的状态。

如果变体的当前类型成功转换，则返回 true；否则返回 false。

包含从 QObject 派生的类型指针的 QVariant 也将转换并返回该函数的 true，如果 qobject_cast 到由 targetType 描述的类型将成功。注意，这仅适用于使用 Q_OBJECT 宏的 QObject 子类。

此函数是在 Qt 6.0 中引入的。

另请参阅：canConvert() 和 clear。

void *QVariant::data()

返回对包含对象的指针作为通用的 void*，可以进行写入。

此函数使 QVariant 分离。当在 null-QVariant 上调用时，调用后 QVariant 不会为空。

另请参阅 get_if() 和 QMetaType.

[since 6.6] template <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> T &QVariant::emplace(Args &&... args)

将当前在 *this 中持有的对象替换为类型为 T 的对象，从 args... 构建而成。如果 *this 非空，则首先销毁先前持有的对象。如果可能，此方法将重用 QVariant 分配的内存。返回对新创建对象的引用。

此函数是在 Qt 6.6 中引入的。

[since 6.6] 模板 <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> T &QVariant::emplace(std::initializer_list<U> list, Args &&... args)

这是一个重载函数。

此重载存在是为了支持接受 initializer_list 构造函数的类型。它的行为与不接受初始化列表的重载等效。

此函数是在 Qt 6.6 中引入的。

[静态，since 6.7] QVariant QVariant::fromMetaType(QMetaType type, const void *copy = nullptr)

创建类型为 type 的变体，并在 copy 不是 nullptr 的情况下（在此情况下，copy 必须指向类型为 type 的对象）用 *copy 的副本初始化它。

注意，您必须传递要存储的对象的地址。

通常，您不需要使用此构造函数，而是使用 QVariant::fromValue() 来从由 QMetaType::VoidStar 和 QMetaType::QObjectStar 表示的指针类型构造变元。

如果 type 不支持复制构造，并且 copy 不是 nullptr，则变元将为无效。同样，如果 copy 是 nullptr 且 type 不支持默认构造，则变元将为无效。

返回上面描述创建的 QVariant。

此函数是在 Qt 6.7 中引入的。

另请参阅QVariant::fromValue() 和 QMetaType::Type。

[静态] 模板 <typename... Types> QVariant QVariant::fromStdVariant(const std::variant<Types...> &value)

返回一个具有 value 活跃变体的类型和价值 QVariant。如果活跃类型是 std::monostate，则返回默认的 QVariant。

另请参阅fromValue。

[静态，since 6.6] 模板 <typename... Types> QVariant QVariant::fromStdVariant(std::variant<Types...> &&value)

这是一个重载函数。

此函数是在 Qt 6.6 中引入的。

[静态] 模板 <typename T> QVariant QVariant::fromValue(const T &value)

返回包含 value 复制的 QVariant。否则行为与 setValue() 相同。

示例

MyCustomStruct s;
return QVariant::fromValue(s);

另请参阅setValue() 和 value。

[静态，since 6.6] 模板 <typename T, QVariant::if_rvalue<T> = true> QVariant QVariant::fromValue(T &&value)

这是一个重载函数。

此函数是在 Qt 6.6 中引入的。

bool QVariant::isNull() const

如果这是一个空变体，则返回 true，否则返回 false。

如果变体不包含已初始化的值或空指针，则认为它是空的。

另请参阅 convert().

bool QVariant::isValid() const

如果此变体的存储类型不是QMetaType::UnknownType，则返回true；否则返回false。

[since 6.0] QMetaType QVariant::metaType() const

返回存储在变体中的值的QMetaType。

此函数是在 Qt 6.0 中引入的。

template <typename T, typename = std::enable_if_t<!std::is_same_v<std::decay_t<T>, QVariant>>> void QVariant::setValue(T &&value)

存储value的副本。如果T是QVariant不支持的数据类型，则使用QMetaType存储此值。如果QMetaType无法处理该类型，将产生编译错误。

示例

QVariant v;

v.setValue(5);
int i = v.toInt();         // i is now 5
QString s = v.toString();  // s is now "5"

MyCustomStruct c;
v.setValue(c);

...

MyCustomStruct c2 = v.value<MyCustomStruct>();

另请参阅value，fromValue和canConvert。

void QVariant::setValue(const QVariant &value)

将value复制到这个QVariant中。它等同于将value简单赋给这个QVariant。

void QVariant::setValue(QVariant &&value)

将value移动到这个QVariant中。它等同于将value简单地移动赋值给这个QVariant。

[noexcept] void QVariant::swap(QVariant &other)

将变体other与此变体交换。此操作非常快速且从不失败。

QBitArray QVariant::toBitArray() const

如果变体有userType() QMetaType::QBitArray，则将变体返回为QBitArray；否则返回一个空比特数组。

另请参阅canConvert和convert。

bool QVariant::toBool() const

如果变体有userType为Bool，则将变体返回bool。

如果变体的userType为QMetaType::Bool，QMetaType::QChar，QMetaType::Double，QMetaType::Int，QMetaType::LongLong，QMetaType::UInt或QMetaType::ULongLong且值非零，或者变体类型为QMetaType::QString或QMetaType::QByteArray且其小写内容不是以下之一：空、"0"或"false"；否则返回false。

另请参阅canConvert和convert。

QByteArray QVariant::toByteArray() const

如果变种具有 userType() QMetaType::QByteArray 或 QMetaType::QString (使用 QString::fromUtf8 转换) 的用户类型，则将变种作为 QByteArray 返回；否则返回空字节数组。

另请参阅canConvert和convert。

QChar QVariant::toChar() const

如果变种具有 userType() QMetaType::QChar、QMetaType::Int 或 QMetaType::UInt 的用户类型，则将变种作为 QChar 返回；否则返回一个无效的 QChar。

另请参阅canConvert和convert。

QDate QVariant::toDate() const

如果变种具有 userType() QMetaType::QDate、QMetaType::QDateTime 或 QMetaType::QString 的用户类型，则将变种作为 QDate 返回；否则返回一个无效的日期。

如果类型是 QMetaType::QString，而且字符串不能被解析为 Qt::ISODate 格式的日期，则将返回无效日期。

另请参阅canConvert和convert。

QDateTime QVariant::toDateTime() const

如果变种具有 userType() QMetaType::QDateTime、QMetaType::QDate 或 QMetaType::QString 的用户类型，则将变种作为 QDateTime 返回；否则返回无效的日期/时间。

如果类型是 QMetaType::QString，而且字符串不能被解析为 Qt::ISODate 格式的日期/时间，则将返回无效的日期/时间。

另请参阅canConvert和convert。

double QVariant::toDouble(bool *ok = nullptr) const

如果变种具有 userType() QMetaType::Double、QMetaType::Float、QMetaType::Bool、QMetaType::QByteArray、QMetaType::Int、QMetaType::LongLong、QMetaType::QString、QMetaType::UInt 或 QMetaType::ULongLong 的用户类型，则将变种作为 double 返回；否则返回 0.0。

如果 ok 非空：如果值可以被转换为一个 double，则将 ok 设置为 true；否则将该 ok 设置为 false。

另请参阅canConvert和convert。

QEasingCurve QVariant::toEasingCurve() const

如果变种具有 userType() QMetaType::QEasingCurve 的用户类型，则将变种作为 QEasingCurve 返回；否则返回默认的缓动曲线。

另请参阅canConvert和convert。

float QVariant::toFloat(bool *ok = nullptr) const

如果变异体有 QMetaType::Double、QMetaType::Float、QMetaType::Bool、QMetaType::QByteArray、QMetaType::Int、QMetaType::LongLong、QMetaType::QString、QMetaType::UInt 或 QMetaType::ULongLong 类型的话，以此返回它作为浮点数；否则返回 0.0。

如果 ok 非空：如果值可以被转换为一个 double，则将 ok 设置为 true；否则将该 ok 设置为 false。

另请参阅canConvert和convert。

QHash<QString, QVariant> QVariant::toHash() const

如果变异体的类型是 QMetaType::QVariantHash，则以 QHash<QString, QVariant> 的形式返回变异体；否则返回一个空映射。

另请参阅canConvert和convert。

int QVariant::toInt(bool *ok = nullptr) const

如果变异体为 QMetaType::Int、QMetaType::Bool、QMetaType::QByteArray、QMetaType::QChar、QMetaType::Double、QMetaType::LongLong、QMetaType::QString、QMetaType::UInt 或 QMetaType::ULongLong 类型，则将其作为 int 返回；否则返回 0。

如果 ok 非空：如果值可以转换为 int，则 ok 被设为 true；否则 ok 被设为 false。

警告：如果值可以转换为 QMetaType::LongLong 但太大无法在 int 中表示，则结果算术溢出将不会反映在 ok 中。一个简单的解决方案是使用 QString::toInt。

另请参阅canConvert和convert。

QJsonArray QVariant::toJsonArray() const

如果变异体为 QJsonArray 类型，则将其作为 QJsonArray 返回；否则返回一个默认构造的 QJsonArray。

另请参阅canConvert和convert。

QJsonDocument QVariant::toJsonDocument() const

如果变异体为 QJsonDocument 类型，则将其作为 QJsonDocument 返回；否则返回一个默认构造的 QJsonDocument。

另请参阅canConvert和convert。

QJsonObject QVariant::toJsonObject() const

如果变异体为 QJsonObject 类型，则将其作为 QJsonObject 返回；否则返回一个默认构造的 QJsonObject。

另请参阅canConvert和convert。

QJsonValue QVariant::toJsonValue() const

如果变异体为 QJsonValue 类型，则将其作为 QJsonValue 返回；否则返回一个默认构造的 QJsonValue。

另请参阅canConvert和convert。

QLine QVariant::toLine() const

如果变异体的userType() 等于 QMetaType::QLine，则返回该变异体作为 QLine；否则返回无效的 QLine。

另请参阅canConvert和convert。

QLineF QVariant::toLineF() const

如果变异体的 userType() 等于 QMetaType::QLineF，则返回该变异体作为 QLineF；否则返回无效的 QLineF。

另请参阅canConvert和convert。

QList<QVariant> QVariant::toList() const

如果变异体的 userType() 等于 QMetaType::QVariantList，则返回变异体作为 QVariantList。如果不是，QVariant 将尝试将类型转换为列表并返回它。这将对任何已注册为转换到 QVariantList 的类型或使用 Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE 声明为顺序容器的类型成功。如果这些条件都不成立，此函数将返回空列表。

另请参阅canConvert和convert。

QLocale QVariant::toLocale() const

如果变异体的 userType() 等于 QMetaType::QLocale，则返回变异体作为 QLocale；否则返回无效的 QLocale。

另请参阅canConvert和convert。

qlonglong QVariant::toLongLong(bool *ok = nullptr) const

如果变异体的 userType() 等于 QMetaType::LongLong、QMetaType::Bool、QMetaType::QByteArray、QMetaType::QChar、QMetaType::Double、QMetaType::Int、QMetaType::QString、QMetaType::UInt 或 QMetaType::ULongLong，则返回变异体作为长整型；否则返回 0。

如果 ok 非空：如果值可以被转换为 int，*ok 被设置为 true；否则 *ok 被设置为 false。

另请参阅canConvert和convert。

QMap<QString, QVariant> QVariant::toMap() const

如果变异体的 type() 等于 QMetaType::QVariantMap，则返回变异体作为 QVariantMap。如果不是，QVariant 将尝试将类型转换为映射并返回它。这将对任何已注册为转换到 QVariantMap 的类型或使用 Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE 声明为关联容器的类型成功。如果这些条件都不成立，此函数将返回空映射。

另请参阅canConvert和convert。

QModelIndex QVariant::toModelIndex() const

如果 variant 对象的 userType() 函数返回 QModelIndex，则返回该 variant 作为 QModelIndex；否则返回默认构造的 QModelIndex。

另请参阅 canConvert()，convert() 以及 toPersistentModelIndex()。

QPersistentModelIndex QVariant::toPersistentModelIndex() const

如果 variant 对象的 userType() 函数返回 QPersistentModelIndex，则返回该 variant 作为 QPersistentModelIndex；否则返回默认构造的 QPersistentModelIndex。

另请参阅 canConvert()，convert() 以及 toModelIndex()。

QPoint QVariant::toPoint() const

如果 variant 对象的 userType() 函数返回 QMetaType::QPoint 或 QMetaType::QPointF，则返回该 variant 作为 QPoint；否则返回空 QPoint。

另请参阅canConvert和convert。

QPointF QVariant::toPointF() const

如果 variant 对象的 userType() 函数返回 QMetaType::QPoint 或 QMetaType::QPointF，则返回该 variant 作为 QPointF；否则返回空 QPointF。

另请参阅canConvert和convert。

qreal QVariant::toReal(bool *ok = nullptr) const

如果 variant 对象的 userType() 函数返回 QMetaType::Double，QMetaType::Float，QMetaType::Bool，QMetaType::QByteArray，QMetaType::Int，QMetaType::LongLong，QMetaType::QString，QMetaType::UInt 或 QMetaType::ULongLong，则返回该 variant 作为 qreal；否则返回 0.0。

如果 ok 非空：如果值可以被转换为一个 double，则将 ok 设置为 true；否则将该 ok 设置为 false。

另请参阅canConvert和convert。

QRect QVariant::toRect() const

如果 variant 对象的 userType() 函数返回 QMetaType::QRect，则返回该 variant 作为 QRect；否则返回无效的 QRect。

另请参阅canConvert和convert。

QRectF QVariant::toRectF() const

如果 variant 对象的 userType() 函数返回 QMetaType::QRect 或 QMetaType::QRectF，则返回该 variant 作为 QRectF；否则返回无效的 QRectF。

另请参阅canConvert和convert。

QRegularExpression QVariant::toRegularExpression() const

如果 variant 是QRegularExpression 类型，则返回 variant 作为 QRegularExpression；否则返回一个空的 QRegularExpression。

另请参阅canConvert和convert。

QSize QVariant::toSize() const

如果 variant 的 userType() 是 QMetaType::QSize 类型，则返回 variant 作为 QSize；否则返回一个无效的 QSize。

另请参阅canConvert和convert。

QSizeF QVariant::toSizeF() const

如果 variant 的 userType() 是 QMetaType::QSizeF 类型，则返回 variant 作为 QSizeF；否则返回一个无效的 QSizeF。

另请参阅canConvert和convert。

QString QVariant::toString() const

如果 variant 的 userType() 包含但不限于以下类型，则返回 variant 作为 QString：

QMetaType::QString、QMetaType::Bool、QMetaType::QByteArray、QMetaType::QChar、QMetaType::QDate、QMetaType::QDateTime、QMetaType::Double、QMetaType::Int、QMetaType::LongLong、QMetaType::QStringList、QMetaType::QTime、QMetaType::UInt 或 QMetaType::ULongLong。

在不支持 variant 上调用 QVariant::toString() 将返回一个空字符串。

另请参阅canConvert和convert。

QStringList QVariant::toStringList() const

如果 variant 的 userType() 是 QMetaType::QStringList、QMetaType::QString 或可转换为 QString 的类型 QMetaType::QVariantList，则返回 variant 作为 QStringList；否则返回一个空列表。

另请参阅canConvert和convert。

QTime QVariant::toTime() const

如果 variant 的 userType() 是 QMetaType::QTime、QMetaType::QDateTime 或 QMetaType::QString，则返回 variant 作为 QTime；否则返回一个无效的时间。

如果类型是 QMetaType::QString，且字符串不能解析为Qt::ISODate 格式的时间，则返回无效时间。

另请参阅canConvert和convert。

uint QVariant::toUInt(bool *ok = nullptr) const

如果 variant 的 userType() 是 QMetaType::UInt、QMetaType::Bool、QMetaType::QByteArray、QMetaType::QChar、QMetaType::Double、QMetaType::Int、QMetaType::LongLong、QMetaType::QString 或 QMetaType::ULongLong，则返回 variant 作为无符号整数；否则返回 0。

如果ok非空：如果值可以被转换成无符号整型，则将ok设置为true；否则将ok设置为false。

警告：如果值可以转换成QMetaType::ULongLong但太大而无法在一个无符号整型中表示，则结果溢出将不会反映在ok中。一个简单的解决方案是使用QString::toUInt。

另请参阅canConvert和convert。

qulonglong QVariant::toULongLong(bool *ok = nullptr) const

如果变量类型为QMetaType::ULongLong、QMetaType::Bool、QMetaType::QByteArray、QMetaType::QChar、QMetaType::Double、QMetaType::Int、QMetaType::LongLong、QMetaType::QString或QMetaType::UInt，则将其作为无符号长长整型返回；否则返回0。

如果 ok 非空：如果值可以转换为 int，则 ok 被设为 true；否则 ok 被设为 false。

另请参阅canConvert和convert。

QUrl QVariant::toUrl() const

如果变量的userType为QMetaType::QUrl，则以QUrl的形式返回变量；否则返回一个无效的QUrl。

另请参阅canConvert和convert。

QUuid QVariant::toUuid() const

如果变量的类型为QMetaType::QUuid、QMetaType::QByteArray或QMetaType::QString，则以QUuid的形式返回变量；否则返回一个默认构造的QUuid。

另请参阅canConvert和convert。

const char *QVariant::typeName() const

返回存储在变量中的类型名称。返回的字符串描述了用于存储数据用的C++数据类型：例如，"QFont"、"QString"或"QVariantList"。无效的变量返回0。

template <typename T> T QVariant::value() const &

将存储的值转换为模板类型T。调用canConvert()以确定是否可以转换类型。如果值不能转换，则返回一个默认构造的值。

如果QVariant支持类型T，则此函数的行为与toString()、toInt()等相同。

示例

QVariant v;

MyCustomStruct c;
if (v.canConvert<MyCustomStruct>())
    c = v.value<MyCustomStruct>();

v = 7;
int i = v.value<int>();                        // same as v.toInt()
QString s = v.value<QString>();                // same as v.toString(), s is now "7"
MyCustomStruct c2 = v.value<MyCustomStruct>(); // conversion failed, c2 is empty

如果QVariant包含指向从QObject派生的类型的指针，则T可以是任何QObject类型。如果存储在QVariant中的指针可以qobject_cast到T，则返回那个结果。否则返回nullptr。注意，这仅适用于使用Q_OBJECT宏的QObject子类。

如果 QVariant 包含一个顺序容器，并且 T 是 QVariantList，则容器中的元素将被转换为 QVariant 并作为 QVariantList 返回。

QList<int> intList = {7, 11, 42};

QVariant variant = QVariant::fromValue(intList);
if (variant.canConvert<QVariantList>()) {
    QSequentialIterable iterable = variant.value<QSequentialIterable>();
    // Can use foreach:
    foreach (const QVariant &v, iterable) {
        qDebug() << v;
    }
    // Can use C++11 range-for:
    for (const QVariant &v : iterable) {
        qDebug() << v;
    }
    // Can use iterators:
    QSequentialIterable::const_iterator it = iterable.begin();
    const QSequentialIterable::const_iterator end = iterable.end();
    for ( ; it != end; ++it) {
        qDebug() << *it;
    }
}

参阅setValue()，fromValue()，canConvert()，以及 Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE。

模板 <typename T> T QVariant::view()

返回对存储值的模板类型 T 的可变视图。调用 canView() 以确定是否支持此类视图。如果不能创建此类视图，则返回转换为模板类型 T 的存储值。调用 canConvert() 以确定是否可以转换类型。如果值既无法查看也无法转换，则返回一个 默认构造的值。

参阅canView() 和 Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE。

QVariant &QVariant::operator=(const QVariant &variant)

将 variant 的值赋给当前 QVariant。

[noexcept] QVariant &QVariant::operator=(QVariant &&other)

移动赋值 other 到当前 QVariant 实例。