QAnyStringView类

成员函数文档

[constexpr noexcept] QAnyStringView::QAnyStringView()

构建一个空字符串视图。

另请参阅 isNull()。

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

构建一个空字符串视图。

另请参阅 isNull()。

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

使用 str 构造字符串视图，长度为 len。

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

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

如果 len 为负，或者当正时如果 str 是 nullptr，则行为未定义。

只有当 Char 是兼容字符类型时，此构造函数才参与重载解析。

另请参阅 isNull() 和 兼容字符类型。

[constexpr] 模板 <typename Char, QAnyStringView::if_compatible_char<Char> = true> QAnyStringView::QAnyStringView(const Char *first, const Char *last)

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

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

如果last也是nullptr，则将nullptr作为first传递是安全的，并导致空字符串视图。

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

只有当 Char 是兼容字符类型时，此构造函数才参与重载解析。

另请参阅 isNull() 和 兼容字符类型。

[constexpr noexcept] 模板 <typename Char, size_t N> QAnyStringView::QAnyStringView(const Char (&)[N] string)

在字符字符串文字string上构造字符串视图。视图覆盖数组直到遇到第一个Char(0)或N，取其较小者。如果您需要整个数组，请使用fromArray()代替。

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

只有当string是实际数组并且Char是兼容字符类型时，此构造函数才参与重载解析。

另请参阅兼容字符类型。

[constexpr noexcept] 模板 <typename Char> QAnyStringView::QAnyStringView(const Char *str)

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

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

将nullptr作为str传递是安全的，并导致空字符串视图。

只有当str不是数组并且Char是兼容字符类型时，此构造函数才参与重载解析。

另请参阅 isNull() 和 兼容字符类型。

[noexcept] QAnyStringView::QAnyStringView(const QByteArray &str)

在str上构造字符串视图。将str中的数据解释为UTF-8。

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

如果str.isNull()，则字符串视图将为空。

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

在str上构造字符串视图。

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

如果str.isNull()，则字符串视图将为空。

[constexpr noexcept] 模板 <typename Container, QAnyStringView::if_compatible_container<Container> = true> QAnyStringView::QAnyStringView(const Container &str)

在str上构造字符串视图。长度采用std::size(str)。

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

只有当Container是一个具有与value_type兼容字符类型的容器时，此构造函数才参与重载解析。

如果并将仅当 std::size(str) == 0，字符串视图将为空。是否此构造函数会导致空字符串视图（必须返回 nullptr，则 std::data(str)）是不确定的。

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

[constexpr] QChar QAnyStringView::back() const

返回字符串视图中的最后一个字符。

此函数提供用于 STL 兼容性。

另请参阅 front() 和 大小和子串。

[constexpr, since 6.5] void QAnyStringView::chop(qsizetype n)

通过 n 代码点截断此字符串视图。

等同于 *this = first(size() - n)。

此函数自 Qt 6.5 起引入。

另请参阅 sliced()，first()，last()，chopped()，truncate() 和 大小和子串。

[constexpr, since 6.5] QAnyStringView QAnyStringView::chopped(qsizetype n) const

返回从该对象开始长度的子串 size() - n。

等同于 first(size() - n)。

此函数自 Qt 6.5 起引入。

另请参阅 sliced()，first()，last()，chop()，truncate() 和 大小和子串。

[static noexcept] int QAnyStringView::compare(QAnyStringView lhs, QAnyStringView rhs, Qt::CaseSensitivity cs = Qt::CaseSensitive)

比较字符串视图 lhs 与字符串视图 rhs 并返回一个负整数，如果 lhs 小于 rhs，则是一个正整数，如果它大于 rhs，为零。

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

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

[constexpr noexcept] const void *QAnyStringView::data() const

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

另请参阅 size_bytes。

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

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

此函数提供用于 STL 兼容性。

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::first(qsizetype n) const

返回一个字符串视图，其中包含此字符串视图的前 n 个字符。

此函数自 Qt 6.5 起引入。

另请参阅 last()，sliced()，chopped()，chop()，truncate()，以及 大小和子字符串。

[constexpr] QChar QAnyStringView::front() const

返回字符串视图中的第一个字符。

此函数提供用于 STL 兼容性。

另请参阅 back() 和 大小和子字符串。

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

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

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

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

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

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

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

另请参阅 empty()，isEmpty() 和 size()。

[constexpr, since 6.5] QAnyStringView QAnyStringView::last(qsizetype n) const

返回一个字符串视图，其中包含此字符串视图的最后 n 个字符。

此函数自 Qt 6.5 起引入。

另请参阅 first()，sliced()，chopped()，chop()，truncate()，以及 大小和子字符串。

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

与 size() 同义。

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

另请参阅 size()。

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

返回此字符串视图的大小，以编码的代码点为单位。

另请参阅 empty()，isEmpty()，isNull()，size_bytes()，以及 大小和子字符串。

[constexpr noexcept] qsizetype QAnyStringView::size_bytes() const

返回此字符串视图的大小，但以字节为单位，而不是代码点。

您可以使用此功能与 data() 一起进行哈希或序列化。

此函数提供用于 STL 兼容性。

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

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos) const

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

此函数自 Qt 6.5 起引入。

另请参阅 first()，last()，chopped()，chop()，truncate() 以及 大小及子字符串。

[constexpr, since 6.5] QAnyStringView QAnyStringView::sliced(qsizetype pos, qsizetype n) const

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

此函数自 Qt 6.5 起引入。

另请参阅 first()，last()，chopped()，chop()，truncate() 以及 大小及子字符串。

QString QAnyStringView::toString() const

返回此字符串视图数据的深拷贝，作为一个 QString。

如果此字符串视图为空，则返回值将是空的 QString。

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

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

等同于 *this = first(n)。

此函数自 Qt 6.5 起引入。

另请参阅 sliced()，first()，last()，chopped()，chop() 以及 大小及子字符串。

[constexpr] template <typename Visitor> decltype(auto) QAnyStringView::visit(Visitor &&v) const

根据此字符串视图引用的字符串数据的编码，调用 v，可能是一个 QUtf8StringView，QLatin1String 或 QStringView。

大多数接受 QAnyStringView 的函数就是通过这种方式分叉为针对特定编码的函数的

void processImpl(QLatin1String s) { ~~~ }
void processImpl(QUtf8StringView s) { ~~~ }
void processImpl(QStringView s) { ~~~ }

void process(QAnyStringView s)
{
    s.visit([](auto s) { processImpl(s); });
}

在这里，我们为 QAnyStringView 对象以及 lambda 参数重用了相同的名称，s。这是惯用代码，有助于通过 visit() 调用跟踪对象的身份，例如，在更复杂的情况下

bool equal(QAnyStringView lhs, QAnyStringView rhs)
{
    // assuming operator==(QAnyStringView, QAnyStringView) didn't, yet, exist:
    return lhs.visit([rhs](auto lhs) {
        rhs.visit([lhs](auto rhs) {
            return lhs == rhs;
        });
    });
}

visit() 要求所有 lambda 实例具有相同的返回类型。如果它们不同，即使存在共同类型，也会在编译时产生错误。为了修复它，您可以在 lambda 上使用显式的返回类型，或在返回语句中进行转换

// wrong:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {   // ERROR: lambdas return different types
        return input.sliced(0, input.size() / 2);
    });
}
// correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) -> QAnyStringView { // OK, explicit return type
        return input.sliced(0, input.size() / 2);
    });
}
// also correct:
QAnyStringView firstHalf(QAnyStringView input)
{
    return input.visit([](auto input) {
        return QAnyStringView(input.sliced(0, input.size() / 2)); // OK, cast to common type
    });
}