QLatin1StringView Class

成员函数文档

[constexpr noexcept] QLatin1StringView::QLatin1StringView()

创建一个 QLatin1StringView 对象，用于存储一个nullptr 。

另请参阅 data()、isEmpty()、isNull() 以及Distinction Between Null and Empty Strings 。

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

创建一个 QLatin1StringView 对象，将其作为str 的视图。

字符串数据不会被复制。调用方必须能够保证，只要 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)

创建一个 QLatin1StringView 对象，用于存储 `str`。

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

另请参阅 latin1()。

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

创建一个 QLatin1StringView 对象，用于存储一个nullptr 。

该函数在 Qt 6.4 中引入。

另请参阅 data()、isEmpty()、isNull() 以及Distinction Between Null and Empty Strings 。

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

构建一个 QLatin1StringView 对象，用于存储字符串first ，其长度为 (last -first)。

在该 Latin-1 字符串对象的生命周期内，[first,last) 范围必须始终有效。

如果last 也是nullptr ，则将nullptr 作为first 传递是安全的，并将返回一个空的 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()。

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

将该字符串中所有%N 替换为args 中的相应参数。这些参数并非按位置对应：args 中的第一个参数将%N 替换为最低的N （所有情况），args 中的第二个参数将%N 替换为次低的N ，以此类推。

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

另请参阅 QString::arg()。

[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

返回一个指向字符串中第一个字符的常量STL 风格迭代器。

提供此函数是为了兼容 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()。

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

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

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

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

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

如果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()。

如果该 Latin-1 字符串视图中包含由str 表示的 UTF-16 字符串、由l1 表示的 Latin-1 字符串，或者字符ch （分别对应上述情况），则返回true ；否则返回false 。

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

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

返回该字符串视图中，由str 显示的 UTF-16 字符串、由l1 显示的 Latin-1 字符串，或字符ch 各自出现的次数（可能存在重叠）。

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

这些函数在 Qt 6.4 中引入。

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

[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()。

如果此 Latin-1 字符串视图以 UTF-16 字符串str 、通过l1 显示的 Latin-1 字符串，或字符ch 结尾，则返回true ；否则返回false 。

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

另请参阅 startsWith()。

[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

返回一个 Latin-1 字符串视图，其中包含该字符串视图的前n 个字符。

该函数在 Qt 6.0 中引入。

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

[constexpr] QLatin1Char QLatin1StringView::front() const

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

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

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

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

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

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

另请参阅 QString::indexOf()。

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

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

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

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

返回此对象所引用的 Latin-1 字符串是否为空（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

返回一个 Latin-1 字符串视图，其中包含该字符串视图的最后n 个字符。

该函数在 Qt 6.0 中引入。

另请参见 first()、endsWith()、chopped()、chop()、truncate() 以及slice()。

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

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

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

另请参阅 indexOf()、QStringView::lastIndexOf()、QStringView::indexOf() 以及QString::indexOf()。

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

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

这些函数是在 Qt 6.2 中引入的。

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

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

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

如果你确定 `length ` 不会超出范围，请在新代码中改用 `first()`，因为它的执行速度更快。

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

如果length 大于或等于size()，或者小于零，则返回整个 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

返回一个指向字符串中第一个字符（按反向顺序）的常量STL 风格反向迭代器。

提供此函数是为了兼容 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()，因为它的执行速度更快。

返回此 Latin-1 字符串视图中，从位置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

返回一个从该字符串视图的pos 位置开始、并延伸至其末尾的Latin-1字符串视图。

该函数在 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()。

如果该 Latin-1 字符串视图以 UTF-16 字符串（由str 表示）、Latin-1 字符串（由l1 表示）或字符ch 开头，则返回true ；否则返回false 。

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

另请参阅 endsWith()。

返回将该QLatin1StringView 转换为相应的浮点数后的结果。

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

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

该函数会忽略开头和结尾的空格字符。

这些函数在 Qt 6.4 中引入。

返回将该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 中引入。

[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()。

[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()。

[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()。