QStringTokenizer Class

メンバ関数のドキュメント

文字列 `haystack ` を、needle が出現する箇所で部分文字列に分割し、検出された部分文字列を順に反復処理できるようにする文字列トークナイザーを構築します。もし `needle ` が `haystack` のどこにも一致しない場合、haystack を含む単一の要素が生成されます。

cs needle の照合を大文字小文字を区別するか、区別しないかを指定します。

sb がQt::SkipEmptyParts の場合、結果には空のエントリは含まれません。デフォルトでは、空のエントリが含まれます。

関連項目: QStringView::split()、QString::split()、Qt::CaseSensitivity 、およびQt::SplitBehavior 。

リストの最初のトークンを指す、STL スタイルのconstイテレータを返します。

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

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

end() と同じです。

cbegin() およびend()も参照してください 。

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

リストの最後のトークンの直後に続く、架空のトークンを指す、STL スタイルのconstセンチネルを返します。

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

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

遅延シーケンスを、LContainer 型の（通常は）ランダムアクセス可能なコンテナに変換します。

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

c として名前付きコンテナ（lvalue）を渡した場合、そのコンテナにデータが格納され、そのコンテナへの参照が返されます。一時コンテナ（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、デフォルト引数を含む）を渡すと、そのコンテナが埋められ、値として返されます。