QStringView Class

成员函数文档

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

关于sep 、behavior 和cs 如何交互形成结果，请参阅QString::split() 。

此函数在 Qt 6.0 中引入。

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

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

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

另请参阅 QString::arg() 。

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

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

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

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

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

另请参阅 endsWith() 。

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

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

另请参阅 startsWith() 。

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

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

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

另请参阅 QString::indexOf() 。

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

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

另请参阅 indexOf() 。

从索引位置from 开始向后搜索，分别返回str 查看的 UTF-16 字符串、l1 查看的 Latin-1 字符串或字符ch 在该字符串视图中最后出现的索引位置。

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

如果未找到str 、l1 或c ，则分别返回-1。

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

另请参见 QString::lastIndexOf().

此函数重载lastIndexOf()。

从本字符串视图的最后一个字符开始向后搜索，返回本字符串视图中最后出现的 UTF-16 字符串的索引位置（分别为str 查看的 UTF-16 字符串或l1 查看的 Latin-1 字符串）。如果未找到str 或l1 ，则分别返回-1。

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

此函数在 Qt 6.2 中引入。

另请参阅 QString::lastIndexOf()。

[constexpr noexcept(...), since 6.0] template <typename Needle, typename... Flags> auto QStringView::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] QStringView::QStringView()

构造空字符串视图。

另请参阅 isNull()。

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

在字符串字面string 上构建字符串视图。视图覆盖数组，直到遇到第一个Char(0) 或N ，以先到者为准。如果需要完整的数组，请使用fromArray() 代替。

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

限制条件

只有当Char 是兼容字符类型时，才会参与重载解析。兼容字符类型有QChar,ushort,char16_t 和（在 Windows 等平台上为 16 位类型）wchar_t 。

另请参阅 fromArray 。

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

在str 上构建字符串视图。长度通过扫描第一个Char(0) 来确定。

str 必须在该字符串视图对象的生命周期内保持有效。

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

限制条件

只有当Char 是兼容字符类型时，才会参与重载解析。兼容字符类型有QChar,ushort,char16_t 和（在 Windows 等平台上为 16 位类型）wchar_t 。

[constexpr noexcept] template <typename Container, QStringView::if_compatible_container<Container> = true> QStringView::QStringView(const Container &str)

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

std::data(str) 必须在该字符串视图对象的生命周期内保持有效。

当且仅当std::size(str) == 0 时，字符串视图将为空。未说明该构造函数是否会导致字符串视图为空（std::data(str) 必须返回nullptr ）。

限制条件

只有当Container 是一个具有与value_type 兼容的字符类型的容器时，才会参与重载解析。兼容的字符类型有QChar,ushort,char16_t 和（在 Windows 等平台上，是 16 位类型）wchar_t 。

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

[noexcept] QStringView::QStringView(const QString &str)

在str 上构造一个字符串视图。

str.data() 必须在该字符串视图对象的生命周期内保持有效。

当且仅当str.isNull().

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

构造空字符串视图。

另请参阅 isNull()。

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *first, const Char *last)

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

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

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

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

限制条件

只有当Char 是兼容字符类型时，才会参与重载解析。兼容的字符类型有QChar,ushort,char16_t 和（在 Windows 等平台上为 16 位类型）wchar_t 。

[constexpr] template <typename Char, QStringView::if_compatible_char<Char> = true> QStringView::QStringView(const Char *str, qsizetype len)

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

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

如果len 也为 0，将nullptr 作为str 传递是安全的，但会导致字符串视图为空。

如果len 为负数，或str 为正数，则行为未定义nullptr 。

限制条件

只有当Char 是兼容字符类型时，才会参与重载解析。兼容字符类型有QChar,ushort,char16_t 和（在 Windows 等平台上为 16 位类型）wchar_t 。

[constexpr noexcept] QChar QStringView::at(qsizetype n) const

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

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

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

[constexpr] QChar QStringView::back() const

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

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

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

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

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

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

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

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

与begin() 相同。

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

另请参阅 cend(),begin(),constBegin(),crbegin() 和data().

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

与end() 相同。

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

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

[constexpr noexcept] void QStringView::chop(qsizetype length)

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

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

另请参阅 mid()、left()、right()、chopped()、truncate() 和slice()。

[constexpr noexcept] QStringView QStringView::chopped(qsizetype length) const

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

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

另请参阅 mid()、left()、right()、chop()、truncate() 和slice()。

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

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

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

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

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

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

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

此函数在 Qt 6.5 中引入。

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

[noexcept, since 6.1] QStringView::const_iterator QStringView::constBegin() const

与begin() 相同。

该函数在 Qt 6.1 中引入。

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

[noexcept, since 6.0] QStringView::const_pointer QStringView::constData() const

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

此函数在 Qt 6.0 中引入。

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

[noexcept, since 6.1] QStringView::const_iterator QStringView::constEnd() const

与end() 相同。

该函数在 Qt 6.1 中引入。

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

[since 6.1] bool QStringView::contains(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

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

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

此函数在 Qt 6.1 中引入。

另请参阅 QRegularExpression::match() 。

[since 6.1] qsizetype QStringView::count(const QRegularExpression &re) const

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

由于历史原因，该函数会计算重叠匹配的次数。这种行为不同于使用QRegularExpressionMatchIterator 在字符串视图中遍历匹配次数。

该函数在 Qt 6.1 中引入。

另请参阅 QRegularExpression::globalMatch()。

[noexcept, since 6.0] qsizetype QStringView::count(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 count()。

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

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

此函数在 Qt 6.0 中引入。

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

[since 6.4] qsizetype QStringView::count(QLatin1StringView l1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const

此函数重载 count()。

返回l1 在此字符串视图中查看的 Latin-1 字符串的（可能重叠的）出现次数。

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

此函数在 Qt 6.4 中引入。

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

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

此函数重载 count()。

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

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

此函数在 Qt 6.0 中引入。

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

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

与rbegin() 相同。

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

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

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

与rend() 相同。

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

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

[noexcept] QStringView::const_pointer QStringView::data() const

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

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

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

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

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

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

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

返回一个常STL 风格的迭代器，指向列表中最后一个字符之后的虚数字符。

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

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

[constexpr] QChar QStringView::first() const

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

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

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

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

返回指向该字符串视图前n 个字符的字符串视图。

此函数在 Qt 6.0 中引入。

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

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

在完整字符串字面string 上构建字符串视图，包括任何尾部Char(0) 。如果不想在视图中包含 null 终结符，可以在确定它位于末尾时将其chop() 掉。另外，您也可以使用构造函数重载数组字面量，这样就可以创建一个视图，直到但不包括数据中的第一个空结束符。

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

如果Char 是兼容字符类型，则该函数可用于任何数组字面量。兼容字符类型包括QChar,ushort,char16_t 以及（在诸如 Windows 等平台上为 16 位类型）wchar_t 。

[constexpr] QChar QStringView::front() const

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

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

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

[since 6.1] qsizetype QStringView::indexOf(const QRegularExpression &re, qsizetype from = 0, QRegularExpressionMatch *rmatch = nullptr) const

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

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

此函数在 Qt 6.1 中引入。

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

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

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

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

[noexcept, since 6.7] bool QStringView::isLower() const

如果该视图与其小写折叠相同，则返回true 。

请注意，这并不意味着字符串视图不包含大写字母（有些大写字母没有小写折叠；toString().toLower() 将保持不变）。有关详细信息，请参阅 Unicode 标准第 3.13 节。

此函数在 Qt 6.7 中引入。

另请参阅 QChar::toLower() 和isUpper()。

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

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

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

另请参阅 empty(),isEmpty(),size() 和length() 。

[noexcept] bool QStringView::isRightToLeft() const

如果字符串视图从右向左读取，则返回true 。

另请参阅 QString::isRightToLeft().

[noexcept, since 6.7] bool QStringView::isUpper() const

如果该视图与其大写字母折叠相同，则返回true 。

请注意，这并不意味着该字符串视图不包含小写字母（有些小写字母没有大写折叠；toString().toUpper() 会保留它们不变）。有关详细信息，请参阅 Unicode 标准第 3.13 节。

此函数在 Qt 6.7 中引入。

另请参阅 QChar::toUpper() 和isLower()。

[noexcept] bool QStringView::isValidUtf16() const

如果字符串视图包含有效的 UTF-16 编码数据，则返回true ，否则返回false 。

请注意，该函数不会对数据执行任何特殊验证；它只是检查数据是否能成功从 UTF-16 解码。假定数据是按主机字节顺序排列的；BOM 的存在毫无意义。

另请参见 QString::isValidUtf16()。

[constexpr] QChar QStringView::last() const

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

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

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

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

返回指向该字符串视图最后n 个字符的字符串视图。

此函数在 Qt 6.0 中引入。

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

[since 6.2] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, QRegularExpressionMatch *rmatch = nullptr) const

返回正则表达式re 在字符串视图中最后匹配的索引位置。如果re 没有匹配到任何地方，则返回-1。

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

此函数在 Qt 6.2 中引入。

[since 6.1] qsizetype QStringView::lastIndexOf(const QRegularExpression &re, qsizetype from, QRegularExpressionMatch *rmatch = nullptr) const

返回正则表达式re 在字符串视图中最后一个匹配字符的索引位置，该位置从索引位置from 之前开始。

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

如果re 没有匹配到任何字符，则返回-1。

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

此函数在 Qt 6.1 中引入。

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

此函数重载了 lastIndexOf()。

此函数在 Qt 6.3 中引入。

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

与size() 相同。

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

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

[since 6.4] int QStringView::localeAwareCompare(QStringView other) const

将此字符串视图与other 字符串视图进行比较，如果此字符串视图小于、等于或大于other 字符串视图，则返回一个小于、等于或大于零的整数。

比较的方式取决于本地和平台。使用该函数可向用户显示已排序的字符串列表。

此函数在 Qt 6.4 中引入。

另请参见 Comparing Strings 。

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

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

此函数在 Qt 6.8 中引入。

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

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

返回maxSize()。

此函数在 Qt 6.8 中引入。

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

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

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

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

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

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

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

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

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

返回此字符串视图的大小，单位为 UTF-16 代码单位（也就是说，代用对在此函数中视为两个，与QString 中相同）。

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

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

修改字符串视图，使其从pos 位置开始，并扩展至n 代码点。

此函数在 Qt 6.8 中引入。

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

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

这是一个重载函数。

修改字符串视图，使其从pos 位置开始，一直延伸到其末尾。

此函数在 Qt 6.8 中引入。

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

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

返回指向n 字符的字符串视图，从pos 位置开始。

此函数在 Qt 6.0 中引入。

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

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

这是一个重载函数。

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

此函数在 Qt 6.0 中引入。

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

[since 6.0] QList<QStringView> QStringView::split(const QRegularExpression &re, Qt::SplitBehavior behavior = Qt::KeepEmptyParts) const

这是一个重载函数。

只要正则表达式re 匹配，它就会将字符串分割成子串视图，并返回这些字符串的列表。如果re 在字符串中没有匹配到，split() 将返回一个单元素列表，其中包含该字符串视图。

此函数在 Qt 6.0 中引入。

[since 6.0] CFStringRef QStringView::toCFString() const

从QStringView 创建一个 CFString。

调用者拥有 CFString 并负责释放它。

此函数在 Qt 6.0 中引入。

[since 6.0] double QStringView::toDouble(bool *ok = nullptr) const

返回转换为double 值的字符串视图。

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

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

字符串转换将始终在 "C "语言区进行。要进行与本地语言相关的转换，请使用QLocale::toDouble()

由于历史原因，此函数不处理千位分隔符。如果需要转换此类数字，请使用QLocale::toDouble() 。

此函数在 Qt 6.0 中引入。

另请参阅 QString::toDouble()。

[since 6.0] float QStringView::toFloat(bool *ok = nullptr) const

返回转换为float 值的字符串视图。

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

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

字符串转换将始终在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toFloat()

此函数在 Qt 6.0 中引入。

另请参阅 QString::toFloat()。

[since 6.0] int QStringView::toInt(bool *ok = nullptr, int base = 10) const

返回使用base 为基数转换为int 的字符串视图，基数默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toInt()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toInt()。

QByteArray QStringView::toLatin1() const

以QByteArray 的形式返回字符串的 Latin-1 表示形式。

如果字符串包含非 Latin1 字符，则行为未定义。

另请参阅 toUtf8(),toLocal8Bit() 和QStringEncoder 。

QByteArray QStringView::toLocal8Bit() const

返回字符串的本地 8 位表示形式QByteArray 。

在 Unix 系统上，这等同于toUtf8()，而在 Windows 系统上，则使用系统当前的代码页。

如果字符串包含的字符不受本地 8 位编码的支持，则行为未定义。

另请参阅 toLatin1()、toUtf8() 和QStringEncoder 。

[since 6.0] long QStringView::toLong(bool *ok = nullptr, int base = 10) const

使用base 的基数将字符串视图转换为long ，默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toLong()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toLong()。

[since 6.0] qlonglong QStringView::toLongLong(bool *ok = nullptr, int base = 10) const

使用base 的基数将字符串视图转换为long long ，默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toLongLong()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toLongLong()。

[since 6.0] NSString *QStringView::toNSString() const

从QStringView 创建一个 NSString。

NSString 会自动释放。

此函数在 Qt 6.0 中引入。

[since 6.0] short QStringView::toShort(bool *ok = nullptr, int base = 10) const

使用base 的基数将字符串视图转换为short ，默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toShort()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toShort()。

QString QStringView::toString() const

以QString 的形式返回该字符串视图数据的深度副本。

如果且仅当该字符串视图为空，返回值将是空QString 。

[since 6.0] uint QStringView::toUInt(bool *ok = nullptr, int base = 10) const

返回使用base 为基数转换为unsigned int 的字符串视图，基数默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toUInt()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toUInt()。

[since 6.0] ulong QStringView::toULong(bool *ok = nullptr, int base = 10) const

返回使用base 为基数转换为unsigned long 的字符串视图，基数默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toULongLong()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toULong()。

[since 6.0] qulonglong QStringView::toULongLong(bool *ok = nullptr, int base = 10) const

返回使用base 为基数转换为unsigned long long 的字符串视图，基数默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toULongLong()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toULongLong()。

[since 6.0] ushort QStringView::toUShort(bool *ok = nullptr, int base = 10) const

返回使用base 为基数转换为unsigned short 的字符串视图，基数默认为 10，且必须介于 2 和 36 之间，否则返回 0。如果转换失败，则返回 0。

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

如果base 为 0，则使用 C 语言惯例：如果字符串视图以 "0x "开头，则使用基数 16；否则，如果字符串视图以 "0 "开头，则使用基数 8；否则，使用基数 10。

字符串转换总是在 "C "语言中进行。要进行与本地语言相关的转换，请使用QLocale::toUShort()

该函数在 Qt 6.0 中引入。

另请参阅 QString::toUShort()。

QList<uint> QStringView::toUcs4() const

返回字符串视图的 UCS-4/UTF-32 表示形式，即QList<uint>。

UCS-4 是一种 Unicode 编解码器，因此是无损的。该字符串视图中的所有字符都将以 UCS-4 编码。该字符串视图中任何无效的编码单位序列都将被 Unicode 替换字符（QChar::ReplacementCharacter ，对应于U+FFFD ）替换。

返回的列表不以 0 结尾。

另请参阅 toUtf8()、toLatin1()、toLocal8Bit() 和QStringEncoder 。

QByteArray QStringView::toUtf8() const

以QByteArray 的形式返回字符串视图的 UTF-8 表示形式。

UTF-8 是一种 Unicode 编解码器，可以表示 Unicode 字符串中的所有字符，如QString 。

另请参阅 toLatin1(),toLocal8Bit() 和QStringEncoder 。

qsizetype QStringView::toWCharArray(wchar_t *array) const

将字符串视图转录到给定的array 中。

调用者有责任确保array 的大小足以容纳wchar_t 编码的字符串视图（分配与字符串视图相同长度的数组总是足够的）。在wchar_t 宽度为 2 字节的平台（如 Windows）上，数组以 UTF-16 编码；否则（Unix 系统），wchar_t 宽度假定为 4 字节，数据以 UCS-4 写入。

返回写入array 的wchar_t 条目数。

另请参阅 QString::toWCharArray()。

[noexcept] QStringView QStringView::trimmed() const

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

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

[constexpr noexcept] void QStringView::truncate(qsizetype length)

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

与*this = left(length) 相同。

另请参阅 mid(),left(),right(),chopped() 和chop() 。

[constexpr noexcept] const QStringView::storage_type *QStringView::utf16() const

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

storage_type 是 。char16_t

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

[noexcept, since 6.7] std::u16string_view QStringView::operator std::u16string_view() const

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

此函数在 Qt 6.7 中引入。

[constexpr] QChar QStringView::operator[](qsizetype n) const

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

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

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