QUtf8StringView Class

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

成员函数文档

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

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

此函数在 Qt 6.5 中引入。

[constexpr noexcept] QUtf8StringView::QUtf8StringView()

构造空字符串视图。

另请参阅 isNull()。

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

在字符串字面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, QUtf8StringView::if_compatible_container<Container> = true> 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, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView::QUtf8StringView(const Char *first, const Char *last)

在first 上构建长度为 (last -first) 的字符串视图。

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

如果last 也是nullptr ，则以first 的形式传递\nullptr 是安全的，但会导致字符串视图为空。

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

限制条件

只有当Char 是兼容字符类型时，才会参与重载解析。兼容的字符类型有char8_t,char,signed char 和unsigned char 。

[constexpr] template <typename Char, QUtf8StringView::if_compatible_char<Char> = true> 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

用args 中的相应参数替换该字符串中出现的%N 。参数不分位置：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

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

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

[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

返回指向字符串视图中第一个码位的常量指针。

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

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

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

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

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

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

返回指向列表中最后一个码位之后的虚数码位的 ConstSTL 样式迭代器。

提供此函数是为了与 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, QUtf8StringView::if_compatible_char<Char> = true> QUtf8StringView QUtf8StringView::fromArray(const Char (&)[Size] string)

在完整字符串字面string 上构建字符串视图，包括任何尾部Char(0) 。如果不想在视图中包含 null 终结符，可以在确定它位于末尾时将其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

返回包含n 代码点的字符串视图，从位置pos 开始。

另请参阅 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 char8_t* 的形式返回，因此只有在 C++20 模式下编译时才能使用此函数。

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

[noexcept, since 6.7] std::basic_string_view<QUtf8StringView::storage_type> QUtf8StringView::operator std::basic_string_view<QUtf8StringView::storage_type>() const

将QUtf8StringView 对象转换为std::basic_string_view 对象。返回的视图将具有与此视图相同的数据指针和长度。返回视图的字符类型为storage_type 。

此函数在 Qt 6.7 中引入。

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

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

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

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