QLatin1StringView Class

成员函数文档

将此字符串视图分别与 UTF-16 字符串视图str 、Latin-1 字符串视图l1 或字符ch 进行比较。如果该字符串小于str 、l1 或ch ，则返回负整数；如果该字符串大于str 、l1 或ch ，则返回正整数；如果两者相等，则返回零。

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

另请参阅 operator==()、operator<() 和operator>()。

如果此 Latin-1 字符串视图分别以str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或字符ch 开始，则返回true ；否则返回false 。

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

另请参阅 endsWith() 。

如果此 Latin-1 字符串视图分别以str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或字符ch 结尾，则返回true ；否则返回false 。

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

另请参阅 startsWith() 。

从索引位置from 开始向前搜索，分别返回str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或字符ch 在此 Latin-1 字符串视图中首次出现的索引位置。如果未找到str 、l1 或c ，则分别返回-1。

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

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

另请参阅 QString::indexOf() 。

如果此 Latin-1 字符串视图包含str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或字符ch ，则分别返回true ；否则返回false 。

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

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

从索引位置from 向后搜索，分别返回str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或ch 查看的字符在此 Latin-1 字符串视图中最后出现的索引位置；如果未找到str 、l1 或ch ，则分别返回-1。

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

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

另请参见 indexOf()、QStringView::lastIndexOf()、QStringView::indexOf() 和QString::indexOf()。

该函数重载了lastIndexOf()。

分别返回str 查看的 UTF-16 字符串或l1 查看的 Latin-1 字符串在此 Latin-1 字符串视图中最后出现的索引位置。如果未找到str 或l1 ，则分别返回-1。

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

此函数在 Qt 6.2 中引入。

返回该字符串视图中分别由str 查看的 UTF-16 字符串、由l1 查看的 Latin-1 字符串或字符ch 的（可能重叠的）出现次数。

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

此函数在 Qt 6.4 中引入。

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

返回QLatin1StringView ，并使用base （默认为 10）转换为相应的数值。支持从 0 和 2 到 36 的基数，用字母表示 9 以上的数字；A 表示 10，B 表示 11，依此类推。

如果base 为 0，则使用以下规则（按此顺序）自动确定基数：如果 Latin-1 字符串视图以：

• "0x"则其余部分读作十六进制（基数 16）
• "0b", 其余部分读作二进制（进制 2）
• "0"其余部分读作八进制（基数 8）
• 否则读作十进制

如果转换失败，则返回 0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

此函数忽略前导字符和尾部间隔字符。

此函数在 Qt 6.4 中引入。

返回QLatin1StringView 转换为相应浮点数的值。

如果转换溢出，则返回无穷大；如果转换因其他原因（如下溢）失败，则返回 0.0。

如果ok 不是nullptr ，则通过将 *ok 设置为false 来报告失败，通过将 *ok 设置为true 来报告成功。

此函数忽略前导字符和尾部间隔字符。

此函数在 Qt 6.4 中引入。

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

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

Args 可以由隐式转换为 的任何内容组成。QAnyStringView

另请参阅 QString::arg() 。

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QLatin1StringView::tokenize(Needle &&sep, Flags... flags) const

在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] QLatin1StringView::QLatin1StringView()

构造一个存储nullptr 的 QLatin1StringView 对象。

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

[explicit constexpr noexcept, since 6.3] QLatin1StringView::QLatin1StringView(QByteArrayView str)

在str 上构造一个 QLatin1StringView 对象作为视图。

字符串数据不会被复制。调用者必须能够保证，只要 QLatin1StringView 对象存在，str 所指向的数据就不会被删除或修改。大小从str 原样获取，不检查是否有空字符终止符。

此函数在 Qt 6.3 中引入。

另请参阅 latin1() 。

[explicit noexcept] QLatin1StringView::QLatin1StringView(const QByteArray &str)

构造一个 QLatin1StringView 对象，作为str 上的一个视图。

字符串数据不会被复制。调用者必须能够保证，只要 QLatin1StringView 对象存在，str 就不会被删除或修改。

另请参阅 latin1().

[explicit constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str)

构造一个存储str 的 QLatin1StringView 对象。

字符串数据不会被复制。调用者必须能够保证，只要 QLatin1StringView 对象存在，str 就不会被删除或修改。

另请参阅 latin1().

[constexpr noexcept, since 6.4] QLatin1StringView::QLatin1StringView(std::nullptr_t)

构造一个存储nullptr 的 QLatin1StringView 对象。

该函数在 Qt 6.4 中引入。

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

[constexpr] QLatin1StringView::QLatin1StringView(const char *first, const char *last)

构造一个 QLatin1StringView 对象，该对象存储长度为 (last -first) 的first 。

[first,last) 的范围必须在此 Latin-1 字符串对象的生命周期内保持有效。

如果last 也是nullptr ，则以first 的形式传递nullptr 是安全的，并会产生一个空 Latin-1 字符串。

如果last 在first 之前，first 是nullptr 而last 不是，或者last - first > INT_MAX.

[constexpr noexcept] QLatin1StringView::QLatin1StringView(const char *str, qsizetype size)

构造一个 QLatin1StringView 对象，该对象用size 保存str 。

字符串数据不会被复制。调用者必须能够保证，只要 QLatin1StringView 对象存在，str 就不会被删除或修改。

另请参见 latin1().

[constexpr] QLatin1Char QLatin1StringView::at(qsizetype pos) const

返回该对象中位于pos 位置的字符。

另请参见 operator[]()。

[constexpr] QLatin1Char QLatin1StringView::back() const

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

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

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

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::begin() const

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

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

另请参阅 end()、cbegin()、rbegin() 和data()。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cbegin() const

与begin() 相同。

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

另请参见 cend()、begin()、crbegin() 和data()。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::cend() const

与end() 相同。

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

另请参见 cbegin()、end() 和crend()。

[constexpr] void QLatin1StringView::chop(qsizetype length)

将此字符串截断为length 字符。

与*this = left(size() - length) 相同。

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

[constexpr] QLatin1StringView QLatin1StringView::chopped(qsizetype length) const

返回从此对象开始的长度为size() -length 的子字符串。

与left(size() - length) 相同。

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

[noexcept, since 6.5] int QLatin1StringView::compare(QUtf8StringView str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

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

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

此函数在 Qt 6.5 中引入。

另请参阅 operator==()、operator<() 和operator>()。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constBegin() const

与begin() 相同。

提供该函数是为了与其他 Qt 容器兼容。

该函数在 Qt 6.4 中引入。

另请参阅 constEnd()、begin()、cbegin() 和data() 。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constData() const

返回此对象引用的 Latin-1 字符串的起始位置。

提供此函数是为了与其他 Qt 容器兼容。

此函数在 Qt 6.4 中引入。

另请参阅 data()。

[constexpr noexcept, since 6.4] const char *QLatin1StringView::constEnd() const

与end() 相同。

提供该函数是为了与其他 Qt 容器兼容。

该函数在 Qt 6.4 中引入。

另请参阅 constBegin()、end()、cend() 和crend() 。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crbegin() const

与rbegin() 相同。

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

另请参见 crend()、rbegin() 和cbegin()。

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::crend() const

与rend() 相同。

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

另请参见 crbegin()、rend() 和cend()。

[constexpr noexcept] const char *QLatin1StringView::data() const

返回此对象引用的 Latin-1 字符串的起始位置。

[constexpr noexcept, since 6.4] bool QLatin1StringView::empty() const

返回此对象引用的 Latin-1 字符串是否为空（size() == 0 ）。

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

此函数在 Qt 6.4 中引入。

另请参阅 isEmpty()、isNull() 和size()。

[constexpr noexcept] QLatin1StringView::const_iterator QLatin1StringView::end() const

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

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

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

[constexpr, since 6.4] QLatin1Char QLatin1StringView::first() const

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

提供此函数是为了与其他 Qt 容器兼容。

此函数在 Qt 6.4 中引入。

另请参阅 last()、front() 和back()。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::first(qsizetype n) const

返回包含此字符串视图前n 个字符的 Latin-1 字符串视图。

此函数在 Qt 6.0 中引入。

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

[constexpr] QLatin1Char QLatin1StringView::front() const

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

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

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

[constexpr noexcept] bool QLatin1StringView::isEmpty() const

返回此对象引用的 Latin-1 字符串是否为空（size() == 0 ）。

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

[constexpr noexcept] bool QLatin1StringView::isNull() const

返回此对象引用的 Latin-1 字符串是否为 null (data() == nullptr)。

另请参阅 isEmpty() 和data()。

[constexpr, since 6.4] QLatin1Char QLatin1StringView::last() const

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

提供此函数是为了与其他 Qt 容器兼容。

此函数在 Qt 6.4 中引入。

另请参阅 first()、back() 和front()。

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::last(qsizetype n) const

返回包含此字符串视图最后n 个字符的 Latin-1 字符串视图。

此函数在 Qt 6.0 中引入。

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

[noexcept, since 6.3] qsizetype QLatin1StringView::lastIndexOf(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

这是一个重载函数。

该函数在 Qt 6.3 中引入。

[constexpr noexcept] const char *QLatin1StringView::latin1() const

返回此对象引用的 Latin-1 字符串的起始位置。

[constexpr] QLatin1StringView QLatin1StringView::left(qsizetype length) const

如果知道length 不能出界，请在新代码中使用first() 代替，因为它更快。

返回此 Latin-1 字符串视图中从位置 0 开始的长度为length 的子串。

如果length 大于或等于size() 或小于 0，则返回整个 Latin-1 字符串视图。

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

[constexpr noexcept, since 6.4] qsizetype QLatin1StringView::length() const

与size() 相同。

提供该函数是为了与其他 Qt 容器兼容。

该函数在 Qt 6.4 中引入。

[static constexpr noexcept, since 6.8] qsizetype QLatin1StringView::maxSize()

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

此函数在 Qt 6.8 中引入。

[constexpr noexcept, since 6.8] qsizetype QLatin1StringView::max_size() const

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

返回maxSize()。

此函数在 Qt 6.8 中引入。

[constexpr] QLatin1StringView QLatin1StringView::mid(qsizetype start, qsizetype length = -1) const

返回从该 Latin-1 字符串视图中start 位置开始的长度为length 的子串。

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

如果start 超过此字符串视图的长度，则返回一个空的 Latin-1 字符串视图。如果该字符串视图中从start 开始可用的字符少于length ，或者length 为负数（默认值），则函数返回从start 开始可用的所有字符。

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

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::rbegin() const

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

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

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

[noexcept] QLatin1StringView::const_reverse_iterator QLatin1StringView::rend() const

返回一个STL 风格的反向迭代器，以相反的顺序指向字符串中最后一个字符之后。

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

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

[constexpr] QLatin1StringView QLatin1StringView::right(qsizetype length) const

如果知道length 不能出界，请在新代码中使用last() 代替，因为它更快。

返回从size() -length 位置开始的长度为length 的子串。

如果length 大于或等于size() 或小于零，则返回整个 Latin-1 字符串视图。

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

[constexpr noexcept] qsizetype QLatin1StringView::size() const

返回此对象引用的 Latin-1 字符串的大小。

[constexpr, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos)

修改此 Latin-1 字符串视图，使其从pos 位置开始，并延伸至其末尾。

此函数在 Qt 6.8 中引入。

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

[constexpr, since 6.8] QLatin1StringView &QLatin1StringView::slice(qsizetype pos, qsizetype n)

这是一个重载函数。

修改此 Latin-1 字符串视图，使其从pos 位置开始，并扩展至n 字符。

此函数在 Qt 6.8 中引入。

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos) const

返回一个 Latin-1 字符串视图，从该字符串视图中的pos 位置开始，一直延伸到其末尾。

此函数在 Qt 6.0 中引入。

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

[constexpr, since 6.0] QLatin1StringView QLatin1StringView::sliced(qsizetype pos, qsizetype n) const

返回一个 Latin-1 字符串视图，该视图从pos 位置开始指向该字符串视图的n 字符。

此函数在 Qt 6.0 中引入。

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

[since 6.0] QString QLatin1StringView::toString() const

将此 Latin-1 字符串转换为QString 。等价于

return QString(*this);

此函数在 Qt 6.0 中引入。

另请参阅 toUtf8() 。

[since 6.9] QByteArray QLatin1StringView::toUtf8() const

返回字符串的 UTF-8 表示形式QByteArray 。该函数比先转换为QString 更有效。

此函数在 Qt 6.9 中引入。

另请参阅 toString() 和QString::toUtf8()。

[noexcept] QLatin1StringView QLatin1StringView::trimmed() const

删除前导和尾部空白并返回结果。

空白指QChar::isSpace() 返回true 的任何字符。这包括 ASCII 字符'\t'、'\n'、'\v'、'\f'、'\r'和''。

[constexpr] void QLatin1StringView::truncate(qsizetype length)

将此字符串截断为长度为length 的字符串。

与*this = left(length) 相同。

另请参阅 sliced(),first(),last(),chopped() 和chop().

[constexpr] QLatin1Char QLatin1StringView::operator[](qsizetype pos) const

返回该对象中位于pos 位置的字符。

另请参见 at()。