QUtf8StringView Class

    void myfun1(QUtf8StringView sv);        // preferred
    void myfun2(const QUtf8StringView &sv); // compiles and works, but slower

成员函数文档

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

构建一个空字符串视图。

另请参阅 isNull()。

[constexpr noexcept] template <typename Char, size_t N> QUtf8StringView::QUtf8StringView(const Char (&string)[N])

基于字符串字面量string 构建一个字符串视图。该视图覆盖该数组，直至遇到第一个Char(0) ，或者N ，以先发生者为准。如果需要整个数组，请改用fromArray()。

string 必须在该字符串视图对象的生命周期内始终有效。

约束

仅当string 是实际数组，且Char 是兼容字符类型时，才参与重载解析。兼容字符类型包括：char8_t 、char 、signed char 和unsigned char 。

另请参阅 fromArray()。

[constexpr noexcept] template <typename Char> QUtf8StringView::QUtf8StringView(const Char *str)

在str 上构建一个字符串视图。其长度由扫描找到第一个Char(0) 的字符串长度决定。

str 在该字符串视图对象的生命周期内，该参数必须始终有效。

将nullptr 作为str 传递是安全的，并将生成一个空字符串视图。

约束

仅当str 不是数组，且Char 是兼容的字符类型时，才参与重载解析。兼容的字符类型包括：char8_t 、char 、signed char 和unsigned char 。

[constexpr noexcept] template <typename Container> requires if_compatible_container<Container> QUtf8StringView::QUtf8StringView(const Container &str)

在str 上构建一个字符串视图。长度取自std::size(str) 。

std::data(str) 在该字符串视图对象的生命周期内，该长度必须始终有效。

当且仅当std::size(str) == 0 时，字符串视图为空。该构造函数是否会生成空字符串视图未作规定（若要实现这一点，std::data(str) 必须返回nullptr ）。

约束

仅当Container 是与value_type 具有兼容字符类型的容器时，才参与重载解析。兼容的字符类型包括：char8_t 、char 、signed char 和unsigned char 。

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

[constexpr noexcept] QUtf8StringView::QUtf8StringView(std::nullptr_t)

构建一个空字符串视图。

另请参阅 ` isNull()`。

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *first, const Char *last)

在first 上构建一个字符串视图，其长度为(last -first)。

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

如果last 也是nullptr ，则将\nullptr 作为first 传递是安全的，并将生成一个空字符串视图。

如果last 位于first 之前，或者first 为nullptr 而last 不是，则行为未定义。

约束

仅当Char 是兼容的字符类型时，才参与重载解析。兼容的字符类型包括：char8_t 、char 、signed char 和unsigned char 。

[constexpr] template <typename Char> requires if_compatible_char<Char> QUtf8StringView::QUtf8StringView(const Char *str, qsizetype len)

在str 上构建一个长度为len 的字符串视图。

在该字符串视图对象的生命周期内，[str,len) 范围必须始终有效。

如果len 也是 0，则将nullptr 作为str 传递是安全的，并将生成一个空字符串视图。

如果len 为负数，或者当其为正数时str 等于nullptr ，则行为未定义。

约束

仅当Char 是兼容的字符类型时，才参与重载解析。兼容的字符类型包括：char8_t 、char 、signed char 和unsigned char 。

[since 6.9] template <typename... Args> QString QUtf8StringView::arg(Args &&... args) const

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

Args 可以包含任何能隐式转换为QAnyStringView 的类型。

该函数在 Qt 6.9 中引入。

另请参阅 QString::arg(Args&&...)。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::at(qsizetype n) const

返回该字符串视图中位于位置n 处的码点。

如果n 为负数或不小于size()，则行为未定义。

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

[constexpr] QUtf8StringView::storage_type QUtf8StringView::back() const

返回字符串视图中的最后一个码点。与last() 相同。

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

另请参阅 front()。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::begin() const

返回一个指向字符串视图中第一个码点的 constSTL 风格迭代器。

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

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

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::cbegin() const

与begin() 相同。

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

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

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::cend() const

与 `end()` 相同。

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

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

[constexpr] void QUtf8StringView::chop(qsizetype n)

将此字符串视图截断n 个码点。

与 `*this = first(size() - n)` 相同。

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

[constexpr] QUtf8StringView QUtf8StringView::chopped(qsizetype n) const

返回从该对象开头开始，长度为 `size()` - `n ` 的子字符串。

与first(size() - n) 相同。

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

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

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

这些函数首次引入于 Qt 6.5。

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

与rbegin() 相同。

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

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

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

与rend() 相同。

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

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

[constexpr noexcept] QUtf8StringView::const_pointer QUtf8StringView::data() const

返回指向字符串视图中第一个码点的 const 指针。

另请参阅 begin()、end() 和utf8()。

[constexpr noexcept] bool QUtf8StringView::empty() const

返回该字符串视图是否为空——即判断size() == 0 是否为真。

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

另请参阅 isEmpty()、isNull()、size() 以及length()。

[noexcept] QUtf8StringView::const_iterator QUtf8StringView::end() const

返回一个指向列表中最后一个码点之后那个虚构码点的、符合 STL 风格的const迭代器。

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

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

[constexpr] QUtf8StringView QUtf8StringView::first(qsizetype n) const

返回一个字符串视图，其中包含该字符串视图的前n 个代码点。

另请参阅 last()、sliced()、chopped()、chop()、truncate() 以及slice()。

[static constexpr noexcept] template <typename Char, size_t Size> requires if_compatible_char<Char> QUtf8StringView QUtf8StringView::fromArray(const Char (&string)[Size])

基于完整的字符串字面量string （包含Size 个元素，包括任何尾随的Char(0) ）构建一个字符串视图。如果不想将空终止符包含在视图中，可以在确定它位于末尾时通过chop()将其移除。 或者，您可以使用接受数组字面量的构造函数重载，该构造函数将创建一个视图，其范围截至数据中的第一个空终止符（但不包括该空终止符）。

string 在该字符串视图对象的生命周期内，该属性必须始终有效。

如果 `Char ` 是兼容的字符类型，则该函数可与任何数组字面量配合使用。兼容的字符类型包括：char8_t 、char 、signed char 和unsigned char 。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::front() const

返回字符串视图中的第一个码点。与first() 相同。

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

另请参阅 back()。

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

返回该字符串视图是否为空——即size() == 0 。

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

另请参阅 empty()、isNull()、size() 和length()。

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

返回该字符串视图是否为空——即data() == nullptr 。

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

另请参见 empty()、isEmpty()、size() 和length()。

[noexcept, since 6.3] bool QUtf8StringView::isValidUtf8() const

如果该字符串包含有效的 UTF-8 编码数据，则返回 `true `；否则返回 `false `。

该函数在 Qt 6.3 中引入。

[constexpr] QUtf8StringView QUtf8StringView::last(qsizetype n) const

返回一个字符串视图，其中包含该字符串视图中最后n 个代码点。

另请参阅 first()、sliced()、chopped()、chop()、truncate(）以及slice()。

[constexpr noexcept] qsizetype QUtf8StringView::length() const

与size() 相同。

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

另请参阅 empty()、isEmpty()、isNull() 以及size() 函数。

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

它返回视图理论上能够表示的元素最大数量。实际上，该数量可能会小得多，具体取决于系统可用的内存大小。

该函数于 Qt 6.8 版本中引入。

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

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

返回maxSize()。

该函数于 Qt 6.8 中引入。

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

返回一个指向字符串视图中第一个码点的、按反向顺序排列的 constSTL 风格反向迭代器。

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

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

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

返回一个STL 风格的反向迭代器，该迭代器指向字符串视图中最后一个码点之后的一个位置，且顺序为反向。

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

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

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

返回此字符串视图的大小，单位为 UTF-8 码点（也就是说，就本函数而言，多字节序列会被计为多个码点，这与QString 和QStringView 中代理对的处理方式一致）。

另请参阅 empty()、isEmpty()、isNull() 以及length()。

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

将此字符串视图修改为从位置pos 开始，并向后延伸n 个码点。

该函数在 Qt 6.8 中引入。

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

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

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

该函数在 Qt 6.8 中引入。

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos) const

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

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

[constexpr] QUtf8StringView QUtf8StringView::sliced(qsizetype pos, qsizetype n) const

返回一个字符串视图，其中包含该字符串视图中从位置pos 开始的n 个码点。

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

QString QUtf8StringView::toString() const

返回此字符串视图数据的深度拷贝，类型为QString 。

当且仅当该字符串视图为空时，返回值才会是空的QString 。

[constexpr] void QUtf8StringView::truncate(qsizetype n)

将此字符串视图截断为n 个码点。

与*this = first(n) 相同。

另请参见 sliced()、first()、last()、chopped() 以及chop() 函数。

[noexcept] const char8_t *QUtf8StringView::utf8() const

返回指向字符串视图中第一个码点的 const 指针。

结果以const char8_t* 类型返回，因此该函数仅在C++20模式下编译时可用。

另请参见 begin()、end() 和data()。

[noexcept, since 6.7] QUtf8StringView::operator std::string_view() const

将此QUtf8StringView 对象转换为std::string_view 对象。返回的视图将具有与该视图相同的数据指针和长度。

该函数自 Qt 6.7 起引入。

[noexcept, since 6.10] QUtf8StringView::operator std::u8string_view() const

将此QUtf8StringView 对象转换为std::u8string_view 对象。返回的视图将具有与该视图相同的数据指针和长度。

此函数仅在 C++20 模式下编译时可用。

该函数在 Qt 6.10 中引入。

[constexpr] QUtf8StringView::storage_type QUtf8StringView::operator[](qsizetype n) const

返回该字符串视图中位置为n 的码点。

如果n 为负数或不小于size()，则行为未定义。

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