QStringTokenizer Class

成员函数文档

构建一个字符串分词器，该分词器会在字符串haystack 中每次出现needle 时将其拆分为子字符串，并允许在找到这些子字符串时对其进行迭代。如果needle 在haystack 中任何位置均未匹配，则生成一个包含haystack 的单个元素。

cs 指定needle 的匹配应区分大小写还是不区分大小写。

如果sb 为Qt::SkipEmptyParts ，则结果中不会出现空条目。默认情况下，结果中包含空条目。

另请参阅 QStringView::split()、QString::split()、Qt::CaseSensitivity 以及Qt::SplitBehavior 。

返回一个指向列表中第一个令牌的常量STL 风格迭代器。

另请参阅 end() 和cend()。

[constexpr noexcept] QStringTokenizer<Haystack, Needle>::sentinel QStringTokenizer::cend() const

与end() 相同。

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

[constexpr noexcept] QStringTokenizer<Haystack, Needle>::sentinel QStringTokenizer::end() const

返回一个指向列表中最后一个令牌之后的虚拟令牌的、STL 风格的常量哨兵指针。

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

template <typename LContainer> LContainer QStringTokenizer::toContainer(LContainer &&c = {}) const &

将懒加载序列转换为类型为LContainer 的（通常是）随机访问容器。

只有当Container 具有与该标记器的value_type 匹配的value_type 时，此函数才可用。

若为c 传入一个命名容器（左值），则该容器将被填充，并返回对其的引用。若传入一个临时容器（右值，包括默认参数），则该容器将被填充，并按值返回。

// assuming tok's value_type is QStringView, then...
auto tok = QStringTokenizer{~~~};
// ... rac1 is a QList:
auto rac1 = tok.toContainer();
// ... rac2 is std::pmr::vector<QStringView>:
auto rac2 = tok.toContainer<std::pmr::vector<QStringView>>();
auto rac3 = QVarLengthArray<QStringView, 12>{};
// appends the token sequence produced by tok to rac3
//  and returns a reference to rac3 (which we ignore here):
tok.toContainer(rac3);

这为您提供了最大的灵活性，可按您希望的方式存储序列。

template <typename RContainer> RContainer QStringTokenizer::toContainer(RContainer &&c = {}) const &&

将懒序列转换为类型为 `RContainer` 的（通常是）随机访问容器。

除了对 lvalue-this 重载的限制外，此 rvalue-this 重载仅在该 `QStringTokenizer ` 未在内部存储 `haystack` 时才可用，因为这可能会导致容器中充满悬空引用：

auto tokens = QStringTokenizer{widget.text(), u','}.toContainer();
// ERROR: cannot call toContainer() on rvalue
// 'tokens' references the data of the copy of widget.text()
// stored inside the QStringTokenizer, which has since been deleted

要解决此问题，请将 `QStringTokenizer ` 存储在临时变量中：

auto tokenizer = QStringTokenizer{widget.text90, u','};
auto tokens = tokenizer.toContainer();
// OK: the copy of widget.text() stored in 'tokenizer' keeps the data
// referenced by 'tokens' alive.

您可以通过传入一个视图来强制调用此函数：

func(QStringTokenizer{QStringView{widget.text()}, u','}.toContainer());
// OK: compiler keeps widget.text() around until after func() has executed

若将命名容器（左值）作为 `c` 的参数传入，则该容器会被填充，并返回对其的引用；若传入临时容器（右值，包括默认参数），则该容器会被填充，并按值返回。