在软件开发中，我们经常会遇到需要存储多种不同类型数据，但又希望以统一方式处理它们的情况。传统的做法可能是使用 void*，但这会牺牲类型安全性和便利性。好在，现代 C++ 和 Qt 都为我们提供了优雅的解决方案：std::variant 和 QVariant。

今天，我们就来深入探讨这两个强大的数据容器，并了解它们的异同与最佳使用场景。

QVariant：Qt 框架的瑞士军刀

如果你是 Qt 开发者，那么 QVariant 对你来说一定不陌生。它被誉为 Qt 框架的“瑞士军刀”，在 Qt 的各个角落都能看到它的身影，例如：

• 属性系统 (Qt Properties): Qt 的元对象系统使用 QVariant 来存储和操作属性值。
• 模型/视图架构 (Model/View): QVariant 是 QAbstractItemModel 中 data() 函数返回类型，用于在模型和视图之间传输数据。
• 数据库操作: QSqlQuery 可以使用 QVariant 来绑定参数和获取查询结果。
• JSON/QML: 在处理 JSON 数据和 QML 属性时，QVariant 也是核心。

QVariant 的核心思想是值语义，它能够存储 Qt 中常用的各种数据类型，包括基本类型（int, double, QString, QColor, QDateTime 等）、自定义类型（只要注册到元对象系统）甚至 QList<QVariant> 和 QMap<QString, QVariant>，从而实现复杂数据的存储。

QVariant 的主要特点：

1. 类型安全: 尽管它能存储多种类型，但它提供了类型安全的机制来存取数据，避免了 void* 的危险。
2. 自动类型转换: QVariant 提供了方便的 convert() 方法和 canConvert() 方法，尝试将存储的值转换为另一种类型。
3. 支持自定义类型: 通过 Q_DECLARE_METATYPE 和 qRegisterMetaType，你可以让 QVariant 存储你自己的自定义类对象。

示例代码：

#include <QVariant>
#include <QDebug>
#include <QDateTime>

int main() {
    QVariant v_int = 10;
    QVariant v_string = "Hello QVariant";
    QVariant v_datetime = QDateTime::currentDateTime();

    qDebug() << "Int value:" << v_int.toInt();
    qDebug() << "String value:" << v_string.toString();
    qDebug() << "DateTime value:" << v_datetime.toDateTime();

    // 类型转换
    QVariant v_double_from_int = v_int;
    qDebug() << "Double from int:" << v_double_from_int.toDouble(); // 输出 10.0

    // 尝试获取不匹配的类型
    qDebug() << "Try to get string from int:" << v_int.toString(); // 输出 "10" (QVariant 会尝试转换)

    return 0;
}

std::variant：C++17 的类型安全联合体

随着 C++17 标准的发布，std::variant 成为了标准库的一部分，它提供了一个类型安全的、受限的联合体 (discriminated union)。与 QVariant 类似，std::variant 也可以存储不同类型的值，但一次只能存储其中一种类型的值。

std::variant 的主要特点：

1. 零开销抽象: std::variant 被设计为零开销抽象，这意味着在运行时，它的性能与直接使用联合体（union）非常接近。
2. 类型安全: 通过 std::get 或 std::visit 等机制，它强制你在访问数据时知道或检查其类型，从而保证了类型安全。
3. 编译期类型检查: std::variant 在编译期就能捕获许多类型错误。
4. 不存储空值: std::variant 总是包含一个值，它不能是“空的”，除非通过 std::monostate 来明确表示空状态。
5. 不提供自动类型转换: std::variant 不会像 QVariant 那样自动尝试将存储的值转换为你请求的类型。如果你请求的类型不匹配，会抛出异常或导致编译错误。

示例代码：

#include <variant>
#include <string>
#include <iostream>

int main() {
    std::variant<int, double, std::string> v;

    v = 42; // 存储一个 int
    std::cout << "v stores an int: " << std::get<int>(v) << std::endl;

    v = 3.14; // 存储一个 double
    std::cout << "v stores a double: " << std::get<double>(v) << std::endl;

    v = "Hello std::variant"; // 存储一个 string
    std::cout << "v stores a string: " << std::get<std::string>(v) << std::endl;

    // 访问当前存储的类型
    std::cout << "Index of current type: " << v.index() << std::endl; // 2 (对应 string)

    // 尝试访问不匹配的类型会抛出 std::bad_variant_access 异常
    try {
        std::get<double>(v);
    } catch (const std::bad_variant_access& ex) {
        std::cerr << "Exception: " << ex.what() << std::endl;
    }

    // 使用 std::visit
    std::visit([](auto&& arg){
        using T = std::decay_t<decltype(arg)>;
        if constexpr (std::is_same_v<T, int>) {
            std::cout << "Visiting int: " << arg << std::endl;
        } else if constexpr (std::is_same_v<T, double>) {
            std::cout << "Visiting double: " << arg << std::endl;
        } else if constexpr (std::is_same_v<T, std::string>) {
            std::cout << "Visiting string: " << arg << std::endl;
        }
    }, v);

    return 0;
}

QVariant vs. std::variant：主要区别与选择

如何选择？

• 如果你正在开发 Qt 应用程序，并且需要与 Qt 的核心机制（如属性系统、模型/视图、QML）深度集成，那么 QVariant 无疑是首选。 它的便利性、自动转换和与 Qt 框架的无缝集成是其最大的优势。
• 如果你在纯 C++ 环境下开发，或者对性能有极高的要求，并且你可以在编译时确定所有可能的数据类型，那么 std::variant 是一个更优的选择。 它的零开销抽象和编译期类型检查能够带来更好的性能和更强的类型安全性。
• 如果你需要存储自定义类型，并且这些类型不属于 Qt 的元对象系统，那么 std::variant 可能更直接。 对于 QVariant，你需要进行额外的元对象注册。

总结来说： QVariant 更加灵活和“傻瓜式”，适用于 Qt 生态系统中的各种场景；而 std::variant 更强调性能和严格的类型安全，是现代 C++ 的首选。了解它们的特点和适用场景，能够帮助你做出更明智的技术选型，写出更健壮、更高效的代码。