QString Class

成员函数文档

返回包含n 字符串最左端字符的子串。

如果知道n 不能出界，请在新代码中使用first() 代替，因为这样速度更快。

如果n 大于或等于size() 或小于零，则返回整个字符串。

另请参阅 first()、last()、startsWith()、chopped()、chop() 和truncate()。

返回包含n 字符串最右边字符的子串。

如果知道n 不能出界，请在新代码中使用last() 代替，因为这样速度更快。

如果n 大于或等于size() 或小于零，则返回整个字符串。

另请参阅 endsWith()、last()、first()、sliced()、chopped()、chop()、truncate() 和slice()。

从指定的position 索引开始，返回一个包含n 字符的字符串。

如果知道position 和n 不能出界，请在新代码中使用sliced() 代替，因为这样速度更快。

如果position 索引超过字符串长度，则返回空字符串。如果字符串中从给定的position 开始可用的字符少于n ，或者n 为 -1（默认值），函数将返回从指定的position 开始可用的所有字符。

另请参阅 first()、last()、sliced()、chopped()、chop()、truncate() 和slice()。

返回包含此字符串前n 个字符的字符串。

QString x = "Pineapple";
QString y = x.first(4);      // y == "Pine"

此函数在 Qt 6.0 中引入。

另请参阅 last()、sliced()、startsWith()、chopped()、chop()、truncate() 和slice()。

返回包含此字符串最后n 个字符的字符串。

QString x = "Pineapple";
QString y = x.last(5);      // y == "apple"

此函数在 Qt 6.0 中引入。

另请参阅 first()、sliced()、endsWith()、chopped()、chop()、truncate() 和slice()。

返回一个字符串，该字符串从pos 位置开始，包含n 个字符。

QString x = "Nine pineapples";
QString y = x.sliced(5, 4);            // y == "pine"
QString z = x.sliced(5);               // z == "pineapples"

此函数在 Qt 6.0 中引入。

另请参阅 first()、last()、chopped()、chop()、truncate() 和slice() 。

这是一个重载函数。

返回一个字符串，其中包含该字符串从pos 位置开始延伸至其结尾的部分。

此函数在 Qt 6.0 中引入。

另请参阅 first()、last()、chopped()、chop()、truncate() 和slice()。

返回包含size() -len 最左字符的字符串。

另请参阅 endsWith()、first()、last()、sliced()、chop()、truncate() 和slice()。

它返回字符串理论上可容纳的最大元素数。在实践中，受系统可用内存量的限制，这个数字可能会小得多。

此函数在 Qt 6.8 中引入。

template <typename... Args> QString QString::arg(Args &&... args) const

用args 中的相应参数替换该字符串中出现的%N 。参数不分位置：args 的第一个参数用最低的N 替换%N （全部），args 的第二个参数用次低的N 替换%N 等。

Args 可以由隐式转换为 、 或 的任何内容组成。QString QStringView QLatin1StringView

此外，还支持以下类型：QChar,QLatin1Char 。

另请参阅 QString::arg() 。

在sep 出现的地方将字符串分割成子串视图，并返回这些字符串的懒序列。

等同于

return QStringTokenizer{std::forward<Needle>(sep), flags...};

等效，只是在编译器未启用 C++17 类模板参数演绎（CTAD）的情况下工作。

关于sep 和flags 如何交互形成结果，请参见QStringTokenizer 。

QStringTokenizer result = sv.tokenize(sep);

(不带模板参数）。如果不能使用 C++17 CTAD，则必须只将返回值存储在auto 变量中：

auto result = sv.tokenize(sep);

这是因为QStringTokenizer 的模板参数与返回它们的特定tokenize() 重载有非常微妙的依赖关系，而且它们通常与用于分隔符的类型不对应。

此函数在 Qt 6.0 中引入。

另请参见 QStringTokenizer 和qTokenize()。

[constexpr noexcept] QString::QString()

构造一个空字符串。空字符串也被视为空字符串。

另请参阅 isEmpty(),isNull() 和Distinction Between Null and Empty Strings 。

QString::QString(QChar ch)

构造大小为 1 的字符串，其中包含字符ch 。

QString::QString(QLatin1StringView str)

构造由str 查看的 Latin-1 字符串的副本。

另请参见 fromLatin1().

QString::QString(const QByteArray &ba)

构造一个用字节数组ba 初始化的字符串。使用fromUtf8() 将给定的字节数组转换为 Unicode。

您可以在编译应用程序时通过定义QT_NO_CAST_FROM_ASCII 来禁用该构造函数。例如，如果您想确保所有用户可见字符串都通过QObject::tr() 转换，这将非常有用。

另请参阅 fromLatin1()、fromLocal8Bit() 和fromUtf8()。

QString::QString(const char *str)

构造一个字符串，初始化为 8 位字符串str 。使用fromUtf8() 函数将给定的 const char 指针转换为 Unicode。

您可以在编译应用程序时通过定义QT_NO_CAST_FROM_ASCII 来禁用该构造函数。例如，如果您想确保所有用户可见字符串都通过QObject::tr() 转换，这将非常有用。

另请参阅 fromLatin1()、fromLocal8Bit() 和fromUtf8()。

[since 6.1] QString::QString(const char8_t *str)

构造一个以 UTF-8 字符串str 进行初始化的字符串。使用fromUtf8() 函数将给定的 const char8_t 指针转换为 Unicode。

该函数在 Qt 6.1 中引入。

另请参阅 fromLatin1()、fromLocal8Bit() 和fromUtf8()。

[explicit] QString::QString(const QChar *unicode, qsizetype size = -1)

用QChar 数组unicode 的前size 个字符初始化构造一个字符串。

如果unicode 为 0，则构造一个空字符串。

如果size 为负数，则假定unicode 指向一个以'\0'结束的数组，其长度由动态决定。终止的空字符不被视为字符串的一部分。

QString 会深度复制字符串数据。unicode 数据被原样复制，如果存在字节序号，则保留字节序号。

另请参阅 fromRawData().

QString::QString(qsizetype size, QChar ch)

以给定的size 构造字符串，每个字符都设置为ch 。

另请参阅 fill() 。

[noexcept] QString::QString(const QString &other)

构造other 的副本。

由于 QString 是隐式共享的，因此该操作耗时不变。这使得从函数返回 QString 的速度非常快。如果共享实例被修改，它将被复制（写时复制），这需要线性时间。

另请参见 operator=()。

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

Move- 构造一个 QString 实例，使其指向other 所指向的同一对象。

[noexcept] QString::~QString()

销毁字符串。

QString &QString::append(const QString &str)

将字符串str 追加到该字符串的末尾。

举例说明：

QString x = "free";
QString y = "dom";

x.append(y);
// x == "freedom"

这与使用insert() 函数相同：

x.insert(x.size(), y);

append() 函数通常非常快（恒定时间），因为QString 在字符串数据的末尾预分配了额外空间，因此每次都无需重新分配整个字符串即可增长。

另请参阅 operator+=()、prepend() 和insert()。

QString &QString::append(QChar ch)

此函数重载 append()。

将字符ch 追加到该字符串。

QString &QString::append(QLatin1StringView str)

此函数重载 append()。

将str 查看到的 Latin-1 字符串追加到此字符串。

[since 6.0] QString &QString::append(QStringView v)

此函数重载 append()。

将给定的字符串视图v 追加到此字符串，并返回结果。

此函数在 Qt 6.0 中引入。

[since 6.5] QString &QString::append(QUtf8StringView str)

此函数重载 append()。

将 UTF-8 字符串视图str 追加到此字符串。

此函数在 Qt 6.5 中引入。

QString &QString::append(const QByteArray &ba)

此函数重载 append()。

将字节数组ba 追加到此字符串。使用fromUtf8() 函数将给定的字节数组转换为 Unicode。

您可以在编译应用程序时通过定义QT_NO_CAST_FROM_ASCII 来禁用此函数。例如，如果您想确保所有用户可见字符串都经过QObject::tr() 处理，这将非常有用。

QString &QString::append(const char *str)

此函数重载 append()。

将字符串str 追加到此字符串。使用fromUtf8() 函数将给定的 const char 指针转换为 Unicode。

您可以在编译应用程序时通过定义QT_NO_CAST_FROM_ASCII 禁用此函数。例如，如果您想确保所有用户可见字符串都通过QObject::tr() 转换，这将非常有用。

QString &QString::append(const QChar *str, qsizetype len)

此函数重载 append()。

将QChar 数组str 中的len 字符追加到此字符串中。

QString QString::arg(const QString &a, int fieldWidth = 0, QChar fillChar = u' ') const

返回该字符串的副本，其中最低编号的位置标记由字符串a 代替，即%1,%2, ......，%99 。

fieldWidth 指定参数 占用的最小空间。如果 需要的空间小于 ，则在 中填充字符 。如果 为正数，则文本右对齐。负数 则产生左对齐文本。a a fieldWidth fieldWidth fillChar fieldWidth fieldWidth

本例展示了如何创建status 字符串，用于在处理文件列表时报告进度：

QString i;           // current file's number
QString total;       // number of files to process
QString fileName;    // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

首先，arg(i) 替换%1 。然后，arg(total) 替换%2 。最后，arg(fileName) 替换%3 。

与asprintf() 相比，使用 arg() 的一个好处是，如果应用程序的字符串被翻译成其他语言，编号位置标记的顺序可能会改变，但每个 arg() 仍会替换编号最低的未替换位置标记，无论它出现在哪里。此外，如果位置标记%i 在字符串中出现不止一次，arg() 将替换所有位置标记。

如果没有剩余的未替换位置标记，则会输出警告信息，且结果未定义。位置标记数字范围必须在 1 到 99 之间。

QString QString::arg(QChar a, int fieldWidth = 0, QChar fillChar = u' ') const

该函数重载了 arg()。

QString QString::arg(QLatin1StringView a, int fieldWidth = 0, QChar fillChar = u' ') const

这是一个重载函数。

返回该字符串的副本，其中最低编号的位置标记由a 查看的 Latin-1 字符串替换，即%1,%2, ......，%99 。

fieldWidth 指定 占用的最小空间。如果 需要的空间小于 ，则在 中填充字符 。如果 为正数，则文本右对齐。负数 则产生左对齐文本。a a fieldWidth fieldWidth fillChar fieldWidth fieldWidth

与asprintf() 相比，使用 arg() 的一个好处是，如果应用程序的字符串被翻译成其他语言，编号位置标记的顺序可能会改变，但每个 arg() 仍会替换编号最低但未被替换的位置标记，无论它出现在哪里。此外，如果位置标记%i 在字符串中出现不止一次，arg() 将替换所有位置标记。

如果没有剩余的未替换的位置标记，则会打印一条警告信息，并且结果是未定义的。位置标记数字范围必须在 1 到 99 之间。

QString QString::arg(QStringView a, int fieldWidth = 0, QChar fillChar = u' ') const

这是一个重载函数。

返回该字符串的副本，其中最低编号的位置标记由字符串a 代替，即%1,%2, ......，%99 。

fieldWidth 指定 应占用的最小空间。如果 所需的空间小于 ，则用字符 填充到 。如果 为正数，则文本右对齐。负数 则产生左对齐文本。a a fieldWidth fillChar fieldWidth fieldWidth fieldWidth

本例展示了如何创建status 字符串，用于在处理文件列表时报告进度：

int i;                // current file's number
int total;            // number of files to process
QStringView fileName; // current file's name

QString status = QString("Processing file %1 of %2: %3")
                .arg(i).arg(total).arg(fileName);

首先，arg(i) 替换%1 。然后，arg(total) 替换%2 。最后，arg(fileName) 替换%3 。

与asprintf() 相比，使用 arg() 的一个优势是，如果应用程序的字符串被翻译成其他语言，编号位置标记的顺序可能会改变，但每个 arg() 仍会替换编号最低的未替换位置标记，无论它出现在哪里。此外，如果位置标记%i 在字符串中出现不止一次，arg() 将替换所有位置标记。

如果没有剩余的未替换的位置标记，则会打印一条警告信息，并且结果是未定义的。位置标记数字范围必须在 1 到 99 之间。

QString QString::arg(char a, int fieldWidth = 0, QChar fillChar = u' ') const

该函数重载了 arg()。

a 参数被解释为 Latin-1 字符。

QString QString::arg(int a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

a 参数以base 为基数，默认为 10，且必须介于 2 和 36 之间。对于 10 以外的基数，a 将被视为无符号整数。

fieldWidth 指定 填充字符 的最小空间。正值表示文本右对齐，负值表示文本左对齐。a fillChar

%"后可以跟一个 "L"，在这种情况下，序列将被替换为a 的本地化表示。转换使用QLocale::setDefault() 设置的默认语言。如果未指定默认语言，则使用系统语言。如果base 不是 10，'L'标志将被忽略。

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

另请参见 Number Formats 。

QString QString::arg(long a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空间大小。正值表示文本右对齐，负值表示文本左对齐。a fillChar

a 参数以给定的base 表示，默认值为 10，必须介于 2 和 36 之间。

%"后可以跟一个 "L"，在这种情况下，序列将被替换为a 的本地化表示。转换使用默认的本地化表示。默认区域设置由应用程序启动时的系统区域设置决定。可以使用QLocale::setDefault() 进行更改。如果base 不是 10，"L "标志将被忽略。

QString str;
str = QString("Decimal 63 is %1 in hexadecimal")
        .arg(63, 0, 16);
// str == "Decimal 63 is 3f in hexadecimal"

QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
        .arg(12345)
        .arg(12345)
        .arg(12345, 0, 16);
// str == "12345 12,345 3039"

另请参阅 Number Formats 。

QString QString::arg(qlonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空格数。正值表示文本右对齐，负值表示文本左对齐。a fillChar

base 参数指定将整数a 转换为字符串时使用的基数。基数必须在 2 到 36 之间，其中 8 表示八进制数，10 表示十进制数，16 表示十六进制数。

另请参阅 Number Formats 。

QString QString::arg(qulonglong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空间大小。正值表示文本右对齐，负值表示文本左对齐。a fillChar

base 参数指定将整数a 转换为字符串时使用的基数。base 必须介于 2 和 36 之间，其中 8 表示八进制数，10 表示十进制数，16 表示十六进制数。

另请参阅 Number Formats 。

QString QString::arg(short a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空间大小。正值表示文本右对齐，负值表示文本左对齐。a fillChar

base 参数指定将整数a 转换为字符串时使用的基数。基数必须在 2 到 36 之间，其中 8 表示八进制数，10 表示十进制数，16 表示十六进制数。

另请参阅 Number Formats 。

QString QString::arg(uint a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

base 参数用于指定将整数a 转换为字符串时使用的基数。基数必须在 2 和 36 之间。

另请参阅 Number Formats 。

QString QString::arg(ulong a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空格数。正值表示文本右对齐，负值表示文本左对齐。a fillChar

base 参数指定将整数a 转换为字符串时使用的基数。基数必须在 2 到 36 之间，其中 8 表示八进制数，10 表示十进制数，16 表示十六进制数。

另请参阅 Number Formats 。

QString QString::arg(ushort a, int fieldWidth = 0, int base = 10, QChar fillChar = u' ') const

该函数重载了 arg()。

fieldWidth 指定 填充字符 的最小空间大小。正值表示文本右对齐，负值表示文本左对齐。a fillChar

base 参数指定将整数a 转换为字符串时使用的基数。基数必须在 2 到 36 之间，其中 8 表示八进制数，10 表示十进制数，16 表示十六进制数。

另请参阅 Number Formats 。

QString QString::arg(double a, int fieldWidth = 0, char format = 'g', int precision = -1, QChar fillChar = u' ') const

该函数重载了 arg()。

参数a 将根据指定的format 和precision 格式化。详见Floating-point Formats 。

fieldWidth 指定 填充字符 的最小空格。正值表示文本右对齐，负值表示文本左对齐。a fillChar

double d = 12.34;
QString str = QString("delta: %1").arg(d, 0, 'E', 3);
// str == "delta: 1.234E+01"

另请参阅 QLocale::toString(),QLocale::FloatingPointPrecisionOption, 和Number Formats 。

[static] QString QString::asprintf(const char *cformat, ...)

通过格式字符串cformat 和任意参数列表安全地创建格式化字符串。

格式字符串支持标准 C++ 库中 printf() 提供的转换规范、长度修饰符和标志。cformat 字符串和%s 参数必须是 UTF-8 编码。

QString result;
QTextStream(&result) << "pi = " << 3.14;
// result == "pi = 3.14"

对于translations ，尤其是当字符串包含多个转义序列时，应考虑使用arg() 函数。这允许翻译器控制替换的顺序。

另请参见 arg()。

[since 6.6] QString &QString::assign(QAnyStringView v)

用v 的副本替换此字符串的内容，并返回此字符串的引用。

该字符串的大小等于v 的大小，并通过v.toString() 转换为 UTF-16 格式。但与QAnyStringView::toString() 不同的是，该函数仅在估计的大小超过该字符串的容量或该字符串是共享的情况下分配内存。

此函数在 Qt 6.6 中引入。

另请参见 QAnyStringView::toString().

[since 6.6] template <typename InputIterator, QString::if_compatible_iterator<InputIterator> = true> QString &QString::assign(InputIterator first, InputIterator last)

用迭代器范围 [first,last) 中元素的副本替换此字符串的内容，并返回此字符串的引用。

此字符串的大小等于范围 [first,last) 中元素的解码长度，但不必与范围本身的长度相同，因为此函数会将输入字符集透明地重新编码为 UTF-16。

只有当范围中的元素数量，或者对于非 UTF-16 编码的输入，结果字符串的最大可能大小超过此字符串的容量，或者此字符串是共享的，此函数才会分配内存。

• QChar
• QLatin1Char
• char
• unsigned char
• signed char
• char8_t
• char16_t
• (在 Windows 等平台上为 16 位类型）。wchar_t
• char32_t

此函数在 Qt 6.6 中引入。

[since 6.6] QString &QString::assign(qsizetype n, QChar c)

用n 复制c 替换此字符串的内容，并返回此字符串的引用。

该字符串的大小等于n ，且必须是非负数。

只有在n 超过此字符串的容量或此字符串是共享的情况下，此函数才会分配内存。

此函数在 Qt 6.6 中引入。

另请参阅 fill().

const QChar QString::at(qsizetype position) const

返回字符串中给定索引position 处的字符。

position 必须是字符串中的有效索引位置（即 0 <=position <size() ）。

另请参阅 operator[]()。

QChar &QString::back()

返回字符串中最后一个字符的引用。与operator[](size() - 1) 相同。

提供此函数是为了与 STL 兼容。

另请参阅 front()、at() 和operator[]()。

QChar QString::back() const

返回字符串中的最后一个字符。与at(size() - 1) 相同。

提供此函数是为了与 STL 兼容。

另请参阅 front()、at() 和operator[]()。

QString::iterator QString::begin()

返回指向字符串中第一个字符的STL 样式迭代器。

另请参阅 constBegin() 和end()。

QString::const_iterator QString::begin() const

该函数重载 begin()

qsizetype QString::capacity() const

返回在不强制重新分配的情况下字符串可存储的最大字符数。

该函数的唯一目的是提供一种微调QString 内存使用情况的方法。一般来说，您很少需要调用此函数。如果想知道字符串中有多少个字符，请调用size() 。

另请参阅 reserve() 和squeeze()。

QString::const_iterator QString::cbegin() const

返回指向字符串中第一个字符的 ConstSTL 样式迭代器。

另请参阅 begin() 和cend()。

QString::const_iterator QString::cend() const

返回一个指向字符串最后一个字符之后的 ConstSTL 样式迭代器。

另请参阅 cbegin() 和end()。

void QString::chop(qsizetype n)

从字符串末尾删除n 字符。

如果n 大于或等于size() ，则结果为空字符串；如果n 为负数，则相当于传递 0。

示例

QString str("LOGOUT\r\n");
str.chop(2);
// str == "LOGOUT"

如果要删除字符串开头的字符，请使用remove() 代替。

另请参阅 truncate()、resize()、remove() 和QStringView::chop()。

void QString::clear()

清除字符串内容并使其为空。

另请参阅 resize() 和isNull()。

[static noexcept] int QString::compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

将字符串s1 与字符串s2 进行比较，如果s1 小于s2 ，则返回一个负整数；如果大于s2 ，则返回一个正整数；如果两者相等，则返回 0。

如果cs 是Qt::CaseSensitive （默认值），则比较区分大小写；否则比较不区分大小写。

大小写敏感比较完全基于字符的 Unicode 数值，速度非常快，但并不符合人类的期望。请考虑使用localeAwareCompare() 对用户可见字符串进行排序。

int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0

另请参见 operator==()、operator<()、operator>() 和Comparing Strings 。

[noexcept] int QString::compare(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载 compare()。

使用大小写敏感度设置cs ，将 this 与ch 进行比较。

[noexcept] int QString::compare(QLatin1StringView other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 compare()。

与 compare(*this,other,cs) 相同。

[noexcept] int QString::compare(QStringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载 compare()。

使用大小写敏感度设置cs ，将 this 与s 进行比较。

[noexcept] int QString::compare(const QString &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载 compare()。

从词法上比较此字符串和字符串other ，如果此字符串小于other ，则返回一个负整数；如果大于other ，则返回一个正整数；如果两者相等，则返回 0。

与 compare(*this,other,cs) 相同。

[static noexcept] int QString::compare(QLatin1StringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

此函数重载 compare()。

使用大小写敏感度设置cs 对s1 和s2 进行比较。

[static noexcept] int QString::compare(QStringView s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

此函数重载 compare()。

[static noexcept] int QString::compare(const QString &s1, QLatin1StringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

此函数重载 compare()。

使用大小写敏感度设置cs 对s1 和s2 进行比较。

[static noexcept] int QString::compare(const QString &s1, QStringView s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)

此函数重载 compare()。

QString::const_iterator QString::constBegin() const

返回指向字符串中第一个字符的 ConstSTL 样式迭代器。

另请参阅 begin() 和constEnd()。

const QChar *QString::constData() const

返回存储在QString 中数据的指针。该指针可用于访问组成字符串的字符。

请注意，只要字符串未被修改，指针就一直有效。

另请参阅 data(),operator[]() 和fromRawData().

QString::const_iterator QString::constEnd() const

返回一个指向字符串最后一个字符之后的 ConstSTL 样式迭代器。

另请参阅 constBegin() 和end()。

bool QString::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

如果正则表达式re 与该字符串中的某处匹配，则返回true ；否则返回false 。

如果匹配成功且rmatch 不是nullptr ，则还会将匹配结果写入rmatch 指向的QRegularExpressionMatch 对象。

另请参阅 QRegularExpression::match() 。

bool QString::contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

如果该字符串包含字符串str 的出现，则返回true ；否则返回false 。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

示例

QString str = "Peter Pan";
str.contains("peter", Qt::CaseInsensitive);    // returns true

另请参阅 indexOf() 和count()。

bool QString::contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 contains()。

如果字符串中包含字符ch ，则返回true ；否则返回false 。

bool QString::contains(QLatin1StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 contains()。

如果该字符串包含拉丁字母 1 字符串str 的出现，则返回true ；否则返回false 。

[noexcept] bool QString::contains(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 contains()。

如果该字符串包含字符串视图str 的出现，则返回true ；否则返回false 。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

另请参阅 indexOf() 和count()。

qsizetype QString::count(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

返回str 字符串在该字符串中出现的次数（可能重叠）。

如果cs 是Qt::CaseSensitive （默认），则搜索区分大小写；否则搜索不区分大小写。

另请参阅 contains() 和indexOf()。

qsizetype QString::count(const QRegularExpression &re) const

此函数重载 count()。

返回正则表达式re 在字符串中匹配的次数。

由于历史原因，该函数计算重叠匹配的次数，因此在下面的示例中，有四个 "ana "或 "ama "的实例：

QString str = "banana and panama";
str.count(QRegularExpression("a[nm]a"));    // returns 4

这种行为与使用QRegularExpressionMatchIterator 遍历字符串中的匹配项不同。

另请参见 QRegularExpression::globalMatch()。

qsizetype QString::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 count()。

返回字符ch 在字符串中出现的次数。

如果cs 是Qt::CaseSensitive （默认），则搜索区分大小写；否则搜索不区分大小写。

另请参阅 contains() 和indexOf()。

[since 6.0] qsizetype QString::count(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 count()。

返回 viewstr 字符串在该字符串中出现的次数（可能重叠）。

如果cs 是Qt::CaseSensitive （默认），则搜索区分大小写；否则搜索不区分大小写。

此函数在 Qt 6.0 中引入。

另请参阅 contains() 和indexOf()。

QString::const_reverse_iterator QString::crbegin() const

返回一个 ConstSTL 样式的反向迭代器，按相反顺序指向字符串中的第一个字符。

另请参阅 begin()、rbegin() 和rend()。

QString::const_reverse_iterator QString::crend() const

返回一个 ConstSTL 样式的反向迭代器，按相反顺序指向字符串中最后一个字符之后。

另请参阅 end()、rend() 和rbegin()。

QChar *QString::data()

返回存储在QString 中数据的指针。该指针可用于访问和修改组成字符串的字符。

与constData() 和unicode() 不同，返回的数据总是以"（0）"结束。

示例

QStringstr= "Hello world"；QChar*data =str.data();while(!data->isNull()) {    qDebug() << data->unicode();
   ++data; }

请注意，只有在字符串未被其他方式修改时，指针才会保持有效。对于只读访问，constData() 的速度更快，因为它不会导致深度复制。

另请参阅 constData() 和operator[]()。

const QChar *QString::data() const

这是一个重载函数。

另请参阅 fromRawData() 。

QString::iterator QString::end()

返回一个STL 样式的迭代器，指向字符串中最后一个字符之后。

另请参阅 begin() 和constEnd()。

QString::const_iterator QString::end() const

此函数重载 end()。

bool QString::endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

如果字符串以s 结尾，则返回true ；否则返回false 。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

QString str = "Bananas";
str.endsWith("anas");         // returns true
str.endsWith("pple");         // returns false

另请参阅 startsWith() 。

bool QString::endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

如果字符串以c 结尾，则返回true ；否则返回false 。

此函数重载 endsWith()。

bool QString::endsWith(QLatin1StringView s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载了 endsWith()。

[noexcept] bool QString::endsWith(QStringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 endsWith()。

如果字符串以字符串视图str 结尾，则返回true ；否则返回false 。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

另请参阅 startsWith() 。

[since 6.1] QString::iterator QString::erase(QString::const_iterator first, QString::const_iterator last)

从字符串中删除半开放范围 [first,last ) 中的字符。返回一个迭代器，指向紧接在最后一个擦除字符之后的字符（即在擦除之前由last 引用的字符）。

此函数在 Qt 6.1 中引入。

[since 6.5] QString::iterator QString::erase(QString::const_iterator it)

这是一个重载函数。

从字符串中删除it 表示的字符。返回紧随被删除字符之后的字符的迭代器。

QString c = "abcdefg";
auto it = c.erase(c.cbegin()); // c is now "bcdefg"; "it" points to "b"

此函数在 Qt 6.5 中引入。

QString &QString::fill(QChar ch, qsizetype size = -1)

将字符串中的每个字符设置为ch 。如果size 与 -1 不同（默认值），字符串的大小会事先调整为size 。

示例

QString str = "Berlin";
str.fill('z');
// str == "zzzzzz"

str.fill('A', 2);
// str == "AA"

另请参阅 resize().

[static] QString QString::fromCFString(CFStringRef string)

构造一个新的QString ，其中包含string CFString 的副本。

[static, since 6.6] QString QString::fromEcmaString(emscripten::val jsString)

将ECMAScript 字符串 jsString 转换为QString 。如果提供的参数不是字符串，则行为未定义。

此函数在 Qt 6.6 中引入。

另请参阅 toEcmaString()。

[static] QString QString::fromLatin1(const char *str, qsizetype size)

返回以 Latin-1 字符串str 的第一个size 字符初始化的QString 。

如果size 是-1 ，则使用strlen(str) 代替。

另请参阅 toLatin1()、fromUtf8() 和fromLocal8Bit()。

[static, since 6.0] QString QString::fromLatin1(QByteArrayView str)

这是一个重载函数。

返回一个初始化为拉丁字符串str 的QString 。

此函数在 Qt 6.0 中引入。

[static] QString QString::fromLatin1(const QByteArray &str)

这是一个重载函数。

返回一个初始化为拉丁字符串str 的QString 。

[static] QString QString::fromLocal8Bit(const char *str, qsizetype size)

返回以 8 位字符串str 的第一个size 字符初始化的QString 。

如果size 是-1 ，则使用strlen(str) 代替。

在 Unix 系统上，该函数等同于fromUtf8()。请注意，在 Apple 系统上，此函数不会考虑NSString. defaultCStringEncoding或CFStringGetSystemEncoding()，因为这些函数通常会返回传统的 "Western (Mac OS Roman) "编码，现代 Apple 操作系统不应使用这种编码。在 Windows 系统中，使用的是系统当前的编码页。

另请参见 toLocal8Bit()、fromLatin1() 和fromUtf8()。

[static, since 6.0] QString QString::fromLocal8Bit(QByteArrayView str)

这是一个重载函数。

返回一个用 8 位字符串str 初始化的QString 。

在 Unix 系统上，该函数等同于fromUtf8()。请注意，在 Apple 系统上，此函数不考虑NSString. defaultCStringEncoding或CFStringGetSystemEncoding()，因为这些函数通常返回传统的 "Western (Mac OS Roman) "编码，现代 Apple 操作系统不应使用该编码。在 Windows 系统中，将使用系统当前的编码页。

此函数在 Qt 6.0 中引入。

[static] QString QString::fromLocal8Bit(const QByteArray &str)

这是一个重载函数。

返回一个用 8 位字符串str 初始化的QString 。

在 Unix 系统上，该函数等同于fromUtf8()。请注意，在 Apple 系统上，此函数不考虑NSString. defaultCStringEncoding或CFStringGetSystemEncoding()，因为这些函数通常返回传统的 "Western (Mac OS Roman) "编码，现代 Apple 操作系统不应使用该编码。在 Windows 系统中，将使用系统当前的编码页。

[static] QString QString::fromNSString(const NSString *string)

构造一个新的QString ，其中包含string NSString 的副本。

[static] QString QString::fromRawData(const QChar *unicode, qsizetype size)

构造一个QString ，使用数组unicode 中的第一个size Unicode 字符。unicode 中的数据不会被复制。调用者必须能够保证，只要QString （或其未修改的副本）存在，就不会删除或修改unicode 。

任何修改QString 或其副本的尝试都会导致它创建数据的深度副本，从而确保原始数据不会被修改。

下面是一个示例，说明我们如何在内存中的原始数据上使用QRegularExpression ，而无需将数据复制到QString ：

QRegularExpression pattern("\u00A4");
static const QChar unicode[] = {
        0x005A, 0x007F, 0x00A4, 0x0060,
        0x1009, 0x0020, 0x0020};
qsizetype size = sizeof(unicode) / sizeof(QChar);

QString str = QString::fromRawData(unicode, size);
if (str.contains(pattern) {
    // ...
}

另请参阅 fromUtf16() 和setRawData()。

[static] QString QString::fromStdString(const std::string &str)

返回str 字符串的副本。给定字符串假定以 UTF-8 编码，并使用fromUtf8() 函数转换为QString 。

另请参阅 fromLatin1()、fromLocal8Bit()、fromUtf8() 和QByteArray::fromStdString()。

[static] QString QString::fromStdU16String(const std::u16string &str)

返回str 字符串的副本。给定字符串假定以 UTF-16 编码，并使用fromUtf16() 函数转换为QString 。

另请参阅 fromUtf16()、fromStdWString() 和fromStdU32String()。

[static] QString QString::fromStdU32String(const std::u32string &str)

返回str 字符串的副本。给定字符串假定以 UTF-32 编码，并使用fromUcs4() 函数转换为QString 。

另请参阅 fromUcs4()、fromStdWString() 和fromStdU16String()。

[static] QString QString::fromStdWString(const std::wstring &str)

返回str 字符串的副本。如果 wchar_t 的大小为 2 字节（例如在 windows 系统中），则假定给定字符串以 utf16 编码；如果 wchar_t 的大小为 4 字节（大多数 Unix 系统），则假定给定字符串以 ucs4 编码。

另请参阅 fromUtf16()、fromLatin1()、fromLocal8Bit()、fromUtf8()、fromUcs4()、fromStdU16String() 和fromStdU32String()。

[static] QString QString::fromUcs4(const char32_t *unicode, qsizetype size = -1)

返回以 Unicode 字符串unicode （编码为 UTF-32）的第一个size 字符初始化的QString 。

如果size 为-1（默认值），则unicode 必须以 "0 "结尾。

另请参阅 toUcs4()、fromUtf16()、utf16()、setUtf16()、fromWCharArray() 和fromStdU32String()。

[static] QString QString::fromUtf8(const char *str, qsizetype size)

返回以 UTF-8 字符串str 的第一个size 字节初始化的QString 。

如果size 是-1 ，则使用strlen(str) 代替。

UTF-8 是一种 Unicode 编解码器，可以表示 Unicode 字符串中的所有字符，如QString 。不过，UTF-8 也可能出现无效序列，如果发现任何无效序列，将用一个或多个 "替换字符 "替换，或将其抑制。这包括非 Unicode 序列、非字符、超长序列或编码为 UTF-8 的代理码位。

只要所有 UTF-8 字符都在输入数据中结束，该函数就可以用于增量处理输入数据。字符串末尾任何未结束的字符都将被替换或抑制。要进行有状态解码，请使用QStringDecoder 。

另请参见 toUtf8()、fromLatin1() 和fromLocal8Bit()。

[static, since 6.0] QString QString::fromUtf8(QByteArrayView str)

这是一个重载函数。

返回一个以 UTF-8 字符串str 初始化的QString 。

此函数在 Qt 6.0 中引入。

[static] QString QString::fromUtf8(const QByteArray &str)

这是一个重载函数。

返回一个以 UTF-8 字符串str 初始化的QString 。

[static, since 6.1] QString QString::fromUtf8(const char8_t *str)

这是一个重载函数。

该重载仅在以 C++20 模式编译时可用。

此函数在 Qt 6.1 中引入。

[static, since 6.0] QString QString::fromUtf8(const char8_t *str, qsizetype size)

这是一个重载函数。

该重载仅在以 C++20 模式编译时可用。

此函数在 Qt 6.0 中引入。

[static] QString QString::fromUtf16(const char16_t *unicode, qsizetype size = -1)

返回以 Unicode 字符串unicode （ISO-10646-UTF-16 编码）的第一个size 字符初始化的QString 。

如果size 为 -1（默认值），则unicode 必须以"（0）"结束。

该函数检查字节序标记（BOM）。如果缺少，则假定为主机字节序。

与其他 Unicode 转换相比，该函数速度较慢。如果可能，请使用QString(constQChar *, qsizetype) 或QString(constQChar *)。

QString 对 Unicode 数据进行深度拷贝。

另请参阅 utf16()、setUtf16() 和fromStdU16String()。

[static] QString QString::fromWCharArray(const wchar_t *string, qsizetype size = -1)

读取wchar_t 数组的第一个size 编码单位，其起始点string ，将其转换为 Unicode，并将结果作为QString 返回。如果类型的大小为 4 字节，则wchar_t 使用的编码假定为 UTF-32，如果大小为 2 字节，则假定为 UTF-16。

如果size 为-1（默认），则string 必须以"（0）"结束。

另请参阅 fromUtf16()、fromLatin1()、fromLocal8Bit()、fromUtf8()、fromUcs4() 和fromStdWString() 。

QChar &QString::front()

返回字符串中第一个字符的引用。与operator[](0) 相同。

提供此函数是为了与 STL 兼容。

另请参阅 back()、at() 和operator[]()。

QChar QString::front() const

返回字符串中的第一个字符。与at(0) 相同。

提供此函数是为了与 STL 兼容。

另请参阅 back()、at() 和operator[]()。

qsizetype QString::indexOf(QLatin1StringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

从索引位置from 开始向前搜索，返回str 所查看的 Latin-1 字符串在该字符串中首次出现的索引位置。如果未找到str ，则返回-1。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

例如

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

如果from 为-1，则从最后一个字符开始搜索；如果为-2，则从倒数第二个字符开始，依此类推。

另请参阅 lastIndexOf()、contains() 和count()。

qsizetype QString::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

返回正则表达式re 在字符串中第一个匹配的索引位置，从索引位置from 开始向前搜索。如果re 没有匹配到任何位置，则返回-1。

如果匹配成功，且rmatch 不是nullptr ，则还会将匹配结果写入rmatch 指向的QRegularExpressionMatch 对象。

示例

QString str = "the minimum";
str.indexOf(QRegularExpression("m[aeiou]"), 0);       // returns 4

QString str = "the minimum";
QRegularExpressionMatch match;
str.indexOf(QRegularExpression("m[aeiou]"), 0, &match);       // returns 4
// match.captured() == mi

qsizetype QString::indexOf(const QString &str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

从索引位置from 开始向前搜索，返回str 字符串在该字符串中首次出现的索引位置。如果未找到str ，则返回-1。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

例如

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

如果from 为-1，则从最后一个字符开始搜索；如果为-2，则从倒数第二个字符开始，依此类推。

另请参阅 lastIndexOf()、contains() 和count()。

qsizetype QString::indexOf(QChar ch, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载 indexOf()。

从索引位置from 开始向前搜索，返回本字符串中首次出现字符ch 的索引位置。如果未找到ch ，则返回-1。

[noexcept] qsizetype QString::indexOf(QStringView str, qsizetype from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

该函数重载 indexOf()。

从索引位置from 开始向前搜索，返回字符串视图str 在该字符串中首次出现的索引位置。如果未找到str ，则返回-1。

如果cs 是Qt::CaseSensitive （默认值），则搜索区分大小写；否则搜索不区分大小写。

如果from 为-1，则从最后一个字符开始搜索；如果为-2，则从倒数第二个字符开始，依此类推。

另请参阅 QStringView::indexOf()、lastIndexOf()、contains() 和count()。

QString &QString::insert(qsizetype position, const QString &str)

在给定的索引position 处插入字符串str ，并返回该字符串的引用。

示例

QString str = "Meal";
str.insert(1, QString("ontr"));
// str == "Montreal"

该字符串会增长以适应插入。如果position 超过了字符串的末尾，则会向字符串添加空格字符，以达到position ，然后是str 。

另请参阅 append()、prepend()、replace() 和remove()。

QString &QString::insert(qsizetype position, QChar ch)

此函数重载 insert()。

在给定的索引position 处插入ch 。

字符串会增长以适应插入。如果position 超过了字符串的末尾，则会向字符串添加空格字符，以达到position ，然后是ch 。

QString &QString::insert(qsizetype position, QLatin1StringView str)

该函数重载了 insert() 函数。

在给定的索引position 处插入由str 查看的 Latin-1 字符串。

该字符串会增长以适应插入。如果position 超过了字符串的末尾，则会向字符串添加空格字符，以达到position ，然后是str 。

[since 6.0] QString &QString::insert(qsizetype position, QStringView str)

此函数重载 insert()。

在给定的索引position 处插入字符串视图str ，并返回该字符串的引用。

该字符串会增长以适应插入。如果position 超过了字符串的末尾，则会向字符串添加空格字符，以达到position ，然后是str 。

此函数在 Qt 6.0 中引入。

[since 6.5] QString &QString::insert(qsizetype position, QUtf8StringView str)

该函数重载了 insert() 函数。

在给定索引position 处插入 UTF-8 字符串视图str 。