Qt 核心数据类型
掌握 QString、容器类与隐式共享,对接标准库
#为什么要再造一套字符串和容器
学了 STL 的人第一反应通常是:既然有 std::string、std::vector、std::map,Qt 干嘛还要做 QString、QList、QMap?三个现实原因:
第一,历史。Qt 诞生于 1990 年代初,那时 STL 还没标准化、编译器支持极差。第二,统一编码:std::string 只是一个字节容器,不关心编码;QString 内部固定用 UTF-16 存储,天生支持全世界所有语言。第三,隐式共享:Qt 的容器与字符串在拷贝时几乎零开销(下文详述),这让"按值返回大对象"变得廉价,代码可以写得很自然。
现代 Qt 6 的态度是:与 STL 共存,不排斥。Qt 官方甚至建议新项目在纯算法场景下优先用 STL。但在跨越 Qt API 边界时(比如给 QLabel::setText() 传参、从 QComboBox 取数据),你必须用 Qt 的类型。所以你要掌握的核心是两者的无缝转换。
#QString:Qt 的字符串
#include <QString>
#include <QDebug>
QString a = "你好,Qt"; // 从 UTF-8 字面量构造(源文件需为 UTF-8)
QString b = QString::fromUtf8("你好");
QString c = u"你好,Qt"; // C++11 char16_t 字面量,Qt 6 直接支持
qDebug() << a.size(); // 6(按 UTF-16 码元计数,不是字节数)
qDebug() << a.length(); // 同 size(),两者等价#与 std::string 互转
QString qs = "abc中文";
// QString → std::string(指定编码!)
std::string utf8 = qs.toStdString(); // Qt 6 默认转 UTF-8
QByteArray ba = qs.toUtf8(); // 推荐:显式说明是 UTF-8
std::string s1(ba.constData(), ba.size());
// std::string → QString
std::string src = "abc中文";
QString q1 = QString::fromStdString(src); // 假定 src 是 UTF-8
QString q2 = QString::fromUtf8(src.c_str(), src.size()); // 最稳妥关键点:转换时永远显式指明编码。QString::fromStdString() 在 Qt 6 中默认按 UTF-8 解码(Qt 5 用 setCodecForLocale 影响,Qt 6 已统一为 UTF-8),但写出 fromUtf8 能让读代码的人一眼明白意图,也避免 Windows 下的本地编码(GBK)陷阱。
#拼接与格式化
忘掉 + 号拼接吧,Qt 提供了 arg(),它是可翻译的、类型安全的、位置可重排的:
QString name = "张三";
int count = 3;
// 差:字符串拼接,无法翻译(语序被写死)
QString bad = "用户 " + name + " 有 " + QString::number(count) + " 条消息";
// 好:用 arg(),%1 %2 是占位符
QString good = QString("用户 %1 有 %2 条消息").arg(name).arg(count);
qDebug() << good; // "用户 张三 有 3 条消息"
// 占位符可重排,翻译者可以调整语序(比如英文可能是 "There are %2 messages for %1")
QString en = QString("%2 messages for %1").arg(name).arg(count);
// arg() 还能控制数字格式
QString("%1").arg(3.14159, 0, 'f', 2); // "3.14"
QString("%1").arg(255, 0, 16); // "ff"(十六进制)
QString("%1").arg(42, 6, 10, QChar('0')); // "000042"(补零)对比:Python 的 f-string(
f"用户 {name} 有 {count} 条消息")语法更简洁,但不支持"运行时按语言替换语序";Java 的String.format与arg()最接近,但 Java 用的是%s/%d按类型占位,Qt 的%1/%2按序号占位——序号占位正是为翻译设计的,翻译者可以说"把 %2 放到 %1 前面"。
#中文与编码
三个必须记住的事实:
QString内部永远是 UTF-16,与操作系统、与源文件编码无关。- 从外部读入字节(文件、网络、命令行参数)时,你必须知道那些字节是什么编码,然后显式用
fromUtf8/fromLocal8Bit转换。猜编码是 bug 之源。 - 输出到外部时同理:写文件用
toUtf8(),打印到 Windows 控制台可能需要toLocal8Bit()。
// 写文件,统一 UTF-8
QFile f("out.txt");
if (f.open(QIODevice::WriteOnly | QIODevice::Text)) {
f.write(QString("中文内容\n").toUtf8());
}#QByteArray:字节串
QByteArray 是"带长度的 char*",用于存储原始数据:网络报文、文件内容、加密结果、base64 编码。它与 QString 的区别就是没有编码概念。
QByteArray raw = "\x01\x02\xFF"; // 可以安全存放 \0
qDebug() << raw.size(); // 3
qDebug() << raw.toHex(); // "0102ff"
QByteArray b64 = raw.toBase64();
QByteArray json = R"({"name":"张三"})"; // 原始字面量,不用转义
// ---- 隐式共享(COW):写时才真正复制 ----
QString a = "很长很长的一段文本……";
QString b = a; // 此刻不复制内存!只增加引用计数,共享同一份数据
// a 和 b 内部指向同一块数据,refCount = 2
b[0] = 'X'; // 一旦有人要修改,才真正复制一份(detach),再修改
// 现在 a 和 b 各持一份数据与 std::string 互转:QByteArray::toStdString() 和 QByteArray::fromStdString()。注意 QByteArray 保证以 \0 结尾,因此 .constData() 可以直接喂给需要 C 字符串的 API。
隐式共享(COW,写时复制) 是 Qt 容器最重要的性能特性。它意味着:按值传递 QString / QList 是廉价的,你可以放心地写 QString getName() const { return m_name; } 而不必担心拷贝开销。这一点和 Java 的对象引用语义很像——Java 里 String b = a; 也只是复制引用。区别在于 Qt 的 COW 是值语义 + 内部共享,你依然可以把 QString 当作独立的"值"来用,不需要像 Java 那样担心"修改 b 会不会影响 a"(不会,因为 detach)。
有个实践要点:尽量用 const 引用传参(const QString &),避免不必要的引用计数原子操作;同时用 constData() / cbegin() 而非 data() / begin() 访问只读数据,否则会触发不必要的 detach。
对比:
std::string在 C++11 后标准也禁止了 COW(因为线程安全与迭代器失效问题),主流实现(libstdc++)用的是 SSO + 真拷贝。Qt 用原子引用计数保证线程安全的 COW。对使用者来说结论很简单:Qt 容器按值传也很快。
#容器选型:QList / QVector / QMap / QHash / QSet
| Qt 容器 | 底层结构 | 对标的 STL | 何时用 |
|---|---|---|---|
QList<T> | 连续数组(Qt 6) | std::vector<T> | 默认选择,绝大多数场景 |
QVector<T> | — | — | Qt 6 中它是 QList 的别名,仅为兼容保留 |
QMap<Key,T> | 跳表/红黑树,有序 | std::map | 需要按 key 排序遍历 |
QHash<Key,T> | 哈希表,无序 | std::unordered_map | 只要快速查找,比 QMap 快 |
QSet<T> | 哈希表 | std::unordered_set | 去重、判断存在性 |
QMultiHash | 哈希表 | std::unordered_multimap | 一个 key 多个值 |
决策口诀:要排序用 QMap,不排序用 QHash(更快);存序列用 QList;去重用 QSet。
QList<QString> names = {"张三", "李四", "王五"};
names << "赵六"; // Qt 风格的追加(等价于 append)
names.append("钱七");
qDebug() << names.contains("李四"); // true
qDebug() << names.indexOf("李四"); // 1
// 范围 for(推荐)
for (const QString &n : names)
qDebug() << n;
// Qt 的 Java 风格迭代器(可读性好,但比 STL 迭代器慢)
QListIterator<QString> it(names);
while (it.hasNext())
qDebug() << it.next();
// 与 STL 互操作
std::vector<QString> v(names.begin(), names.end());Qt 5 提示:Qt 5 中
QList与QVector是两个不同实现:QList对大对象存指针数组、对小对象内联;QVector是纯连续数组。Qt 6 把QList改成了QVector的实现,旧的QList被移除,并保留QVector作为QList的别名以便迁移。因此 Qt 5 里"用 QVector 存大对象"的经验在 Qt 6 已不适用——Qt 6 一律用 QList。
容器内存放 QObject 派生类时,注意第 4 章的规则:存指针(QList<QWidget*>),不要存值(QObject 不可拷贝)。
#QVariant:类型擦除的万能盒子
QVariant 可以装下任何 Qt 的基本类型与已注册的自定义类型,相当于 Java 的 Object 或 Python 的"任意值",但保留类型信息。
QVariant v;
v = 42; qDebug() << v.typeId() << v.toInt(); // int
v = QString("hello"); qDebug() << v.toString(); // 字符串
v = QColor(Qt::red); qDebug() << v.value<QColor>(); // 自定义类型
// 判断类型
if (v.canConvert<QString>())
qDebug() << v.toString();QVariant 是 Qt 的模型/视图架构、QSettings 配置读写、数据库接口、动态属性系统的通用货币——这些地方需要在编译期不知道类型的情况下传递数据。日常业务代码里不要滥用它,否则就退化成了"没有类型的 C++"。
想让自己的类型能装进 QVariant,需要 Q_DECLARE_METATYPE(MyType)(以及在信号槽跨线程传参时用 qRegisterMetaType<MyType>())。
#文件、目录、时间与定时器
#include <QFile>
#include <QDir>
#include <QFileInfo>
#include <QDateTime>
#include <QTimer>
#include <QDebug>
// 读文本文件
QFile f(":/data/config.txt"); // ":/" 前缀表示读 qrc 资源(第 8 章)
if (f.open(QIODevice::ReadOnly | QIODevice::Text)) {
QTextStream in(&f);
in.setEncoding(QStringConverter::Utf8); // Qt 6 写法
while (!in.atEnd())
qDebug() << in.readLine();
}
// 目录与路径
QDir dir = QDir::home();
qDebug() << dir.entryList(QDir::Files); // 列出文件
qDebug() << dir.filePath("test.txt"); // 拼接路径(自动处理分隔符)
QFileInfo info("/Users/me/a.txt");
qDebug() << info.exists() << info.size() << info.suffix();
// ---- QDateTime ----
QDateTime now = QDateTime::currentDateTime();
qDebug() << now.toString("yyyy-MM-dd hh:mm:ss"); // "2026-10-19 17:53:49"
qDebug() << now.addDays(7).toString(Qt::ISODate);
QDateTime t = QDateTime::fromString("2026-01-01", "yyyy-MM-dd");
qDebug() << t.daysTo(now); // 相差天数
// ---- QTimer ----
auto *timer = new QTimer(this);
timer->setInterval(500);
timer->setTimerType(Qt::CoarseTimer); // 精度:Precise/Coarse/VeryCoarse
connect(timer, &QTimer::timeout, this, [this]() {
qDebug() << "tick" << QTime::currentTime().toString("hh:mm:ss.zzz");
});
timer->start();
// timer->stop();
// 一次性延时调用(很常用)
QTimer::singleShot(1000, this, [](){ qDebug() << "1 秒后执行"; });文件操作的要点:
- 路径分隔符一律用
/,Qt 会在 Windows 上自动转换。不要手写\\。 QFile::open()返回bool,失败原因看errorString()——Qt 不用异常(第 1 章已强调)。- 大文件别用
readAll(),用QTextStream逐行读。 QDir::mkpath()递归建目录,QDir::removeRecursively()递归删(危险,确认路径再用)。
QTimer 依赖事件循环——没有 app.exec() 就不会触发。它也不保证绝对精确,操作系统调度会引入误差;需要毫秒级精确计时应另想办法。
QTimer::singleShot 是 Qt 里最优雅的小工具,相当于 JS 的 setTimeout。注意它也可以跨线程使用,但定时器必须在它所属的线程有事件循环时才工作。
对比:JS 的
setTimeout/setInterval回调在事件循环空闲时执行,语义几乎一样;Python 的threading.Timer会另起线程,与 Qt 的"事件驱动不占线程"思路不同;Java 的javax.swing.Timer在 EDT 上触发,与 Qt 的 QTimer 最接近。
#小结
QString内部 UTF-16,与std::string转换时务必显式指定toUtf8()/fromUtf8()。- 格式化用
arg()的%1序号占位符,而非拼接——这是为多语言语序可调整而设计。 - Qt 容器与字符串采用隐式共享(COW),按值传递开销很低。
- 容器选型:序列用
QList;要排序用QMap,只查用QHash;去重QSet。Qt 6 中QVector即QList。 QVariant是跨类型数据传递的通用容器,用于属性、模型、配置等场景,业务代码勿滥用;QTimer依赖事件循环,singleShot相当于setTimeout。
#练习
- 写一个函数
std::string joinNames(const QList<QString> &names),把 Qt 容器里的中文名字用顿号连接后,以 UTF-8 的std::string返回;再写反向函数。用含中文与 emoji 的数据测试往返是否一致。 - 用
QFile+QTextStream统计一个 UTF-8 文本文件的行数、字符数与单词数,结果用arg()格式化输出(提示:注意 UTF-16 下 emoji 占 2 个size())。 - 构造一个含 10 万个元素的
QList<QString>,用QList与QSet分别做 1 万次contains查询,用QElapsedTimer计时并比较差距,用数据验证"要查快就用 QSet"。 - 写一个倒计时程序:界面显示剩余秒数,用
QTimer每秒更新,归零时用QTimer::singleShot显示提示;要求所有数字用arg()格式化,且所有用户可见文本用tr()包裹。