本章重要 API 函数#

💡 Tips：Qt6 起字符串索引/长度返回 qsizetype（64 位有符号），不再是 int——在 32 位循环里用 int 接受返回值会触发截断告警。另外 QString::mid 的 pos 是”字符数”不是”字节数”，对中文同样按一个 QChar 计，这正是 UTF-16 定长索引的优势（见 qt09）。

本章目录#

点击条目可跳转到对应小节。

学习前后依赖#

💡 Tips：章节顺序上 qt10 本应在 qt09 之前（先懂 char/string 再学转换），但仓库编号把 qt09 放前面也不冲突——两者互为镜像：qt09 讲”QString 与外部字节如何转”，qt10 讲”字符串本身怎么玩”。建议把本篇当作 qt09 的”底层铺垫篇”来回对照读。

1. 概述#

字符串是 GUI 程序里出现频率最高的数据类型：按钮文字、文件路径、网络报文、配置键值……C++ 提供了三层字符串抽象：最底层是 char（单个字节，常用来表示 ASCII 字符）、char*（指向字符数组的指针，C 风格字符串以 \0 结尾）、std::string（C++ 标准动态字符串，自动管理内存）。它们都只是字节序列，不携带编码信息。

Qt 在 std::string 之上提供了 QString（见 qt09），并配一整套容器（顺序容器 QList、关联容器 QMap/QHash 等）来组织数据。qt10 的 hello.cpp 虽以 QString 操作为主体，却恰好覆盖了”字符串基础”的全部核心动作：拼接（append/prepend/+=）、插入（insert）、子串提取（mid/left）、查找定位（indexOf/lastIndexOf）、以及用 QMap 存结构化数据。它本质上是”在 Qt 上下文里练字符串基本功”。

💡 Tips：概述里最该记住的一句话——“char* 是字节、std::string 是字节容器、QString 是 Unicode；操作字符串前先想清楚你手里的是哪一层。” 中文乱码、索引错位，几乎都源于把这三层混为一谈。

2. 核心概念 / 原理#

3. C++ 字符串模型与 Qt 衔接#

下面用 classDiagram 展示从 C++ 原生字符串到 Qt 字符串/容器的层次关系：

层次含义：char 是原子；char*/std::string 是字节层；QString 在字节层之上引入 Unicode 与丰富 API；QMap 等容器用来组织多个字符串/数据。

💡 Tips：图中最关键的边是 std_string <|.. QString——两者通过 toStdString/fromStdString 互转，但转换时默认按 UTF-8（见 qt09）。记住这条桥，就能在”标准库代码”与”Qt 代码”之间无缝搬运字符串，而不丢失编码。

4. 核心代码解析#

qt10_tst-char/hello.cpp 四个测试，逐段拆解（去掉了注释掉的 #if 0 部分，保留实际运行逻辑）：

1
void test01() {
2
    QString str1("hello");
3
    qDebug() << str1;
4
    str1.append('_').prepend("你好,");   // 尾加 '_'，头加 "你好,"
5
    str1 += "!!";                         // += 等价于 append
6
    qDebug() << str1;                     // "你好,hello_!!"
7
    str1.insert(1, "们");                 // 在索引1处插入
8
    qDebug() << str1;                     // "你们好,hello_!!"
9
}

• append/prepend/+= 都返回 QString&，可链式；insert(1,"们") 把”们”插到索引 1（“好”之前），体现 UTF-16 按字符定位。str1 是 QString（UTF-16），构造自 char* 字面量默认 UTF-8（qt09 已讲）。

1
void test02() {
2
    QString str1("/home/rocky/work/code.my.txt");
3
    QString seq('/');
4
    qsizetype last_pos = str1.lastIndexOf(seq);
5
    QString filename = str1.mid(last_pos + seq.size());     // "code.my.txt"
6
    QString postfix  = str1.mid(str1.lastIndexOf('.') + 1); // "txt"
7
    QString pathname = str1.left(last_pos + seq.size());    // "/home/rocky/work/"
8
    qDebug() << filename << postfix << pathname;
9
}

• 这是路径解析经典套路：lastIndexOf('/') 找最后一级分隔符，mid 切文件名，lastIndexOf('.') 切后缀，left 取目录。seq.size() 对 QString("/") 是 1（一个字符），不能用 strlen 思维。

1
void test03() {
2
    QString str1("Content-Type: image/png\r\nContent-length: 34789\r\n");
3
    QString key = "Content-length:";
4
    qsizetype start_pos = str1.indexOf(key);
5
    qsizetype end_pos = str1.indexOf("\r\n", start_pos + key.size());
6
    QString len_str = str1.mid(start_pos + key.size(), end_pos - (start_pos + key.size()));
7
    bool flags = false;
8
    int len = len_str.toInt(&flags);   // 字符串转整数
9
    if (flags) qDebug() << len;        // 34789
10
}

• 这是从文本报文中提取 K-V 值的通用模式：先 indexOf 定位键，再 indexOf 定位值结束符，用 mid(pos, len) 截取，toInt 转换并靠 bool* 判断成败。注意 mid 第二参是长度（不是结束索引），与 last_pos 套路里的单参 mid 不同。

1
void test04() {
2
    QMap<QString, int> res2;
3
    res2.insert("a1", 10);
4
    res2["w1"] = 30;
5
    res2["b1"] = 20;
6
    for (auto x: res2.keys()) {        // keys() 返回有序键列表
7
        qDebug() << x << ": " << res2[x];
8
    }
9
}

• QMap 演示两种写入（insert 与 []）和遍历。keys() 返回按 key 排序的列表（QMap 有序），所以输出顺序为 a1, b1, w1 而非插入顺序——这是 QMap 与 QHash 的关键区别。

💡 Tips：这段代码藏着的细节——① str1.insert(1,"们") 的索引基于字符而非字节，对中文安全；② test03 的 mid(start+key.size(), len) 第二参必须是长度，写成 mid(start, end) 会多取；③ QMap::keys() 遍历时若在大循环里高频调用有拷贝开销，生产环境更推荐 for (auto it = res2.cbegin(); ...) 或 C++11 范围 for 直接遍历 res2（得键值对）。

5. 运行效果 / 验证#

编译运行 qt10_tst-char，预期输出：

• test01：依次打印 hello、你好,hello_!!、你们好,hello_!!。
• test02：code.my.txt txt /home/rocky/work/。
• test03：打印 34789（从报文正确提取整数）。
• test04：按 a1: 10 b1: 20 w1: 30 顺序输出（注意是按键排序，非插入序）。

💡 Tips：验证时最容易误判”成功”的假象——只看到有输出就以为算法对。应单独核对每步索引：比如 test02 的 pathname 末尾是否带 /、test03 的 len 是不是恰好 34789 而非 3478 或带空格。字符串切分差一个索引，值就错一位，肉眼难辨，务必逐项核对边界。

容易踩坑（注意点）#

• 坑 1：把 QString::length() 当字节数。现象：中文长度计算错误。原因：它返回字符数（UTF-16）。规避：要字节数用 toUtf8().size()。
• 坑 2：mid(pos, n) 第二参是长度不是结束索引。现象：截多了/截少了。原因：与某些语言的 slice(start,end) 语义不同。规避：牢记 n 是长度；单参 mid(pos) 才是截到末尾。
• 坑 3：QMap 误当插入序。现象：遍历顺序和插入不一致。原因：QMap 按键有序。规避：要保序用 QList<QPair> 或 Qt6 的 QKeyValueIterator 配合 QHash+顺序列表。
• 坑 4：用 char* 字面量拼接 std::string 后直接喂 QString 却乱码。现象：中文乱。原因：源文件非 UTF-8（qt09 坑 1）。规避：源码存 UTF-8，或 fromLocal8Bit。
• 坑 5：循环里反复 QString::mid 大字符串。现象：性能下降。原因：每次 mid 都拷贝子串。规避：Qt6 用 QStringView 零拷贝切片，或先 const QChar*。
• 坑 6：toInt(&ok) 不看 ok 直接信任结果。现象：非法字符串得到 0 误当真值。原因：toInt 失败返回 0。规避：永远检查 bool ok。

学习要点总结#

Q&A（常见问题）#

Q1：QString::length() 和 toUtf8().size() 有什么区别？ A1：length() 返回 UTF-16 字符数（中文算 1 个），toUtf8().size() 返回 UTF-8 字节数（中文通常 3 字节）。例如 QString("你好").length() 是 2，.toUtf8().size() 是 6。需要”网络/文件字节数”用后者，需要”显示字符数”用前者。

Q2：mid(pos, n) 和 mid(pos) 怎么用才不会错？ A2：mid(pos, n) 从 pos 取 n 个字符；mid(pos) 从 pos 取到末尾。常见错误是把第二参写成”结束索引”，正确应是”长度”。例如取 str 第 3 到第 5 字符（含）应写 str.mid(2, 3)（起始索引 2、长度 3），不是 mid(2,5)。

Q3：Qt5/Qt6 在字符串/容器上有差异吗？ A3：QString 索引类型由 int 变为 qsizetype（Qt6），QStringRef 被 QStringView 取代（零拷贝视图）；QMap/QHash 接口基本兼容。Qt6 推荐用 QStringView 替代临时 mid 拷贝做切片，减少内存分配。其余增删改查语义两版一致。

Tips（全局速记）#