QStringTokenizer 类

成员函数文档

构造一个字符串标记器，将字符串 haystack 按照在哪个位置找到 needle 将其分割成子字符串，并允许遍历这些字符串。如果 needle 在 haystack 中没有匹配项，则只生成包含 haystack 的单个元素。

cs 指定是否应区分大小写地匹配 needle。

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

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

返回一个指向列表中第一个标记的常量 STL-style iterator。

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

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

与 end() 相同。

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

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

返回一个指向列表中最后一个标记之后假想标记的常量 STL-style 标志。

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

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

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

如果 Container 有一个与这个标记器 value_type 匹配的 value_type，那么这个函数才是可用的。

如果你传入了名为的容器（一个 lvalue）给 c，则该容器会被填充，并返回对该容器的引用。如果你传入了临时容器（一个 rvalue，包括默认参数），则该容器会被填充，并通过值返回。

// 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 传入了一个命名容器（一个 lvalue），则该容器将被填充，并返回对该容器的引用。如果你传递了一个临时容器（一个 rvalue，包括默认参数），则该容器将被填充，并通过值返回。