QStringTokenizer Class

成员函数文档

构造一个字符串标记器，将haystack 中出现needle 的字符串分割成子串，并在找到这些字符串时对其进行迭代。如果needle 与haystack 中的任何内容都不匹配，则会生成包含haystack 的单个元素。

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

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

另请参阅 QStringView::split(),QString::split(),Qt::CaseSensitivity, 和Qt::SplitBehavior 。

返回指向列表中第一个标记的 ConstSTL 样式迭代器。

另请参阅 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 传递了一个命名容器（lvalue），那么该容器将被填充，并返回对它的引用。如果传入一个临时容器（r 值，包括默认参数），则该容器将被填充，并按值返回。

// 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 内部不存储干草堆时才可用，因为这可能会创建一个充满悬垂引用的容器：

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 传递了一个命名的容器（lvalue），那么该容器就会被填满，并返回对它的引用。如果传递的是临时容器（r 值，包括默认参数），则该容器将被填充，并以值返回。