QStringTokenizer Class

Dokumentation der Mitgliedsfunktionen

Konstruiert einen Zeichenketten-Tokenizer, der die Zeichenkette haystack an allen Stellen, an denen needle vorkommt, in Teilzeichenketten zerlegt und eine Iteration über diese Zeichenketten ermöglicht, sobald sie gefunden werden. Wenn needle nirgendwo in haystack vorkommt, wird ein einzelnes Element erzeugt, das haystack enthält.

cs gibt an, ob needle unter Beachtung der Groß- und Kleinschreibung abgeglichen werden soll.

Wenn sb gleich Qt::SkipEmptyParts ist, erscheinen leere Einträge nicht im Ergebnis. Standardmäßig werden leere Einträge eingeschlossen.

Siehe auch QStringView::split(), QString::split(), Qt::CaseSensitivity, und Qt::SplitBehavior.

Gibt einen Iterator im Stil von const STL zurück, der auf das erste Token in der Liste zeigt.

Siehe auch end() und cend().

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

Dasselbe wie end().

Siehe auch cbegin() und end().

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

Gibt einen Sentinel im Stil von const STL zurück, der auf das imaginäre Token nach dem letzten Token in der Liste zeigt.

Siehe auch begin() und cend().

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

Konvertiert die Lazy Sequence in einen (typischerweise) Random-Access-Container des Typs LContainer.

Diese Funktion ist nur verfügbar, wenn Container einen value_type hat, der mit dem value_type dieses Tokenizers übereinstimmt.

Wenn Sie einen benannten Container (einen l-Wert) für c übergeben, wird dieser Container gefüllt und ein Verweis auf ihn zurückgegeben. Wenn Sie einen temporären Container (einen r-Wert, einschließlich des Standardarguments) übergeben, wird dieser Container gefüllt und als Wert zurückgegeben.

// 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);

Dies gibt Ihnen die größtmögliche Flexibilität, wie die Sequenz gespeichert werden soll.

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

Dies ist eine überladene Funktion.

Konvertiert die Lazy Sequence in einen (typischerweise) Random-Access-Container vom Typ RContainer.

Zusätzlich zu den Einschränkungen für die lvalue-this-Überladung ist diese rvalue-this-Überladung nur verfügbar, wenn QStringTokenizer den Heuhaufen nicht intern speichert, da dies einen Container voller baumelnder Referenzen erzeugen könnte:

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

Um das zu beheben, speichern Sie die QStringTokenizer in einem temporären:

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.

Sie können die Existenz dieser Funktion erzwingen, indem Sie stattdessen eine Ansicht übergeben:

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

Wenn Sie einen benannten Container (einen l-Wert) für c übergeben, wird dieser Container gefüllt und ein Verweis auf ihn zurückgegeben. Wenn Sie einen temporären Container (einen r-Wert, einschließlich des Standardarguments) übergeben, wird dieser Container gefüllt und als Wert zurückgegeben.