QString：常用成员函数总结

QString 是 Qt 中使用频率最高的几种数据类型之一，主要在于其提供了大量功能强大的成员函数，这里重点介绍一些常用的成员函数：

一、字符串处理相关

1.1 split() （拆分字符串）

split() 函数可以将一个字符串，拆分成一个装有多个子串的 QStringList。示例如下：

QString str = "polluter pays principle";

//根据空格拆分字符串

QStringList words = str.split(" ");

qDebug() << words; //returns ("polluter", "pays", "principle")

在上面的例子，我们把 "polluter pays principle" 分成三个子串： "polluter", "pays" 和 "principle"。

1.2 section()（分割字符串）

section() 函数用来以某个字符分割字符串。函数原型为：

QString QString::section (QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault) const

这个函数把字符串看成是几个块，这些块由 sep 分隔，start 和 end 指定块号，end 默认为 –1 ，返回的是[ start, end ]内的块组成的字符串。

下面例子功能：从字符串 “one, two, three, four” 中获取第二个由 ‘，’ 分隔的子串，即 “two”。

QString str = "one, two, three, four";

cout << str.section(',', 1, 1).trimmed().toStdString() << endl; //returns two

结果是 “two”，前后不包含空格。上面的函数 trimmed() 是去掉字符串前后的 ASCII 字符 '\t', '\n', '\v', '\f', '\r' 和 ' '。

再看一个例子，这个例子是从字符串 “one, two* three / four / five ^ six” 中获取由 ‘,’ 和 ‘^’ 分隔的第二个子串，即 “four”；

QString str = "one, two* three / four / five ^ six";

cout << str.section(QRegExp("[,*/^]"), 3, 3).trimmed().toStdString() << endl;

上面用到了一个简单的正则表达式，在 Qt 中可以由类 QRegExp 构造，函数 section() 支持使用正则表达式。

1.3 mid() （截取子串）

mid() 截取子串，即返回给定位置（参数1）到给定长度（参数2）的子串，如果不带参数2，就会返回起点到字符串末尾为止的子串。示例如下：

QString x = "Nine pineapples";

QString y = x.mid(5, 4);            // y == "pine"

QString z = x.mid(5);               // z == "pineapples"

类似的还有 left() 和 right()，分别返回左起n个字符（左截取）和右起n个字符（右截取），相比之下，mid() 可以从任意起点开始截取子串，功能更加强大，也更通用。

1.4 replace() （替换子串）

replace() 可以替换掉源串中的部分子串，最常用的函数原型为：

QString &QString::replace(int position, int n, const QString &after)

参数1为开始替换的位置，参数2为新子串的长度，参数3为新子串。示例如下：

QString x = "Say yes!";

QString y = "no";

x.replace(4, 3, y); // x == "Say no!"

二、类型转换相关

QString 提供了大量类型转换的成员函数，因此项目中经常拿它作为处理中介类型。

2.1 QString 转 char*

示例如下：

char *charP;

QString str = "hello";

charP = str.toLatin1().data();

其中 toLatin1() 转换为 QByteArray 类型后，再用 data() 将 QByteArray 类型的字符串转换成 char* 类型。

2.2 char* 转 QString

示例如下：

char *charP = "hello";

QString str = QString(charP);

2.3 QString 转 int/double 等数值类型

toInt() 函数原型如下：

int toInt(bool *ok=0, int base=10) const;

参数1 ok 表示转换是否成功，成功则 ok 为 true，失败则 ok 为 false。参数2 base 表示转换进制，默认为10进制。如果是默认10进制，而字符串非纯数字，最终转换int的结果为0。对于16进制同理。

示例如下：

QString str1 = "FF";

QString str2 = "23";

QString str3 = "12.3";

bool ok = false;

int hex = str1.toInt(&ok,16); // hex == 255, ok == true

int dec = str2.toInt(); // dec == 23, ok == true

float fNum = str3.toFloat(); // fNum == 12.3, ok == true

2.4 int/double 等数值类型转 QString

int/double 类型转换 QString 类型，使用 QString::number() 函数；

第一个参数为：需要转换的int/double数据；第二个参数为：基数。10, 2, 8等；第三个参数为：精度；

int num = 15;

double doubleVal = 15.23;

QString strDec = QString::number(num); // strDec == "15"

QString strHex = QString::number(num,16).toUpper(); // strHex == "F"

QString strDouble = QString::number(doubleVal, 10, 2); // strDouble == "15.23"

toUpper() 可以将小写字母转换为大写字母。也可以使用 setNum() 函数，示例如下：

QString str1,str2;

str1.setNum(20);

str2.setNum(12.3);

qDebug() << str1; //returns "20"

qDebug() << str2; //returns "12.3"

三、构建字符串相关

3.1 sprintf()

组合字符串的一个完全不同的方式，示例如下：

str.sprintf("%s %.1f%%", "perfect competition", 100.0);

支持同样的格式说明符像 C++ 库的 sprintf() 函数。在上面的例子中，str被赋值为 "perfect competition 100.0%"。

3.2 arg()

用另外一个字符串或数字来构建字符串的另外一种方式，示例如下：

QString str = QString("%1:%2 %3:%4").arg("time").arg("2019-5-30").arg("value").arg(25.8); //returns "time:2019-5-30 value:25.8"

在这个例子中，"%1" 被 "time" 替换，"%2 被 "2019-5-30" 替换，"%3" 被 "value" 替换，而 "%4" 被 25.8 替换。结果是 "time:2019-5-30 value:25.8"。

通常，arg() 是比 sprintf() 更好的解决方案，因为它是类型安全（type-safe）的，，完全支持 Unicode，且支持各种各样的数据类型。

四、查询字符串相关

4.1 isEmpty()

isEmpty() 判断字符串是否为空，如果是则返回 true，否则返回 false。示例如下：

qDebug() << QString().isEmpty(); //returns true

qDebug() << QString("").isEmpty(); //returns true

qDebug() << QString(" ").isEmpty(); //returns false （空格也是字符）

qDebug() << QString("a").isEmpty(); //returns false

4.2 contains()

contains() 判断字符串中是否有子字符串，如果有则返回 true，否则返回 false。示例如下：

QString str = "winter is coming";

qDebug() << str.contains("coming"); //returns true

qDebug() << str.contains("bad"); //returns false

4.3 indexOf()

indexOf() 查询是否包含特定子串，返回起始位置，返回 -1 表示未查到。参数1即查询的子串，参数2表示查询的起点。示例如下

QString x = "sticky question";

QString y = "sti";

x.indexOf(y);               // returns 0

x.indexOf(y, 1);            // returns 10

x.indexOf(y, 10);           // returns 10

x.indexOf(y, 11);           // returns -1

第3个参数 Qt::CaseSensitivity 可以选择大小写敏感，一般使用缺省值 Qt::CaseSensitive 表示开启大小写敏感。

4.4 startsWith() 和 endsWith()

检查一个字符串是否是以某物开始或结束，我们可以使用 startsWith() 和 endsWith() 函数。示例如下：

if (url.startsWith("http:") && url.endsWith(".png"))

这个要比下面的简单快速：

if (url.left(5) == "http:" && url.right(4) == ".png")

五、过滤字符串相关

5.1 trimmed()

若需要过滤掉字符串两端的空白符（'\t', '\v', '\f', '\r', '\n', 和' '），可以使用 trimmed() 函数。示例如下：

QString str = " time is good\t";

qDebug() << str.trimmed(); //returns "time is good"

5.2 simplified()

如果不只是需要过滤掉两端的空白符，还希望将一个或多个内部空白符替换为单个空格，这时候就要用到 simplified() 函数。示例如下：

QString str = "  time\t\n   is\n   good\t";

qDebug() << str.simplified(); //returns "time is good"

参考：

CSDN - QString的一些用法总结(1 section, split 函数)

CSDN - 强大的QString：一些常用且方便的成员

简书 - Qt QString类用法总结

CSDN - QString常用成员函数