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

リストの最後のトークンの後にある架空のトークンを指す constSTL 形式のセンチネルを返します。

begin() およびcend()も参照してください 。

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

遅延シーケンスをLContainer 型の（通常）ランダムアクセスコンテナに変換する。

この関数は、Container が、このトークナイザのvalue_type と一致するvalue_type を持っている場合にのみ利用可能です。

c に名前付きコンテナ（l値）を渡すと、そのコンテナが満たされ、そのコンテナへの参照が返される。一時的なコンテナ（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 が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 に名前付きコンテナ（l値）を渡すと、そのコンテナが満たされ、そのコンテナへの参照が返される。一時的なコンテナ（デフォルト引数を含むr値）を渡すと、そのコンテナが満たされ、値が返されます。