QStringTokenizer Class

Ausführliche Beschreibung

QStringTokenizer<Haystack, Needle> ist eine Template-Klasse, wobei „ Haystack “ der Typ der zu tokenisierenden Zeichenkette und „ Needle “ der Typ des Trennzeichens ist. In der Praxis sollten Sie diese Template-Argumente niemals explizit angeben müssen; sie werden vom Compiler automatisch abgeleitet.

Teilt eine Zeichenkette an allen Stellen, an denen ein bestimmtes Trennzeichen vorkommt, in Teilzeichenketten auf und gibt eine (verzögert erzeugte) Liste dieser Zeichenketten zurück. Wenn das Trennzeichen an keiner Stelle in der Zeichenkette vorkommt, wird eine Liste mit einem Element erzeugt, die diese Zeichenkette enthält. Ist das Trennzeichen leer, erzeugt `QStringTokenizer` eine leere Zeichenkette, gefolgt von jedem einzelnen Zeichen der Zeichenkette und anschließend einer weiteren leeren Zeichenkette. Die beiden Aufzählungen ` Qt::SplitBehavior ` und ` Qt::CaseSensitivity ` steuern die Ausgabe zusätzlich.

QStringTokenizer steuert ` QStringView::tokenize()` an, aber Sie können diese Funktion auch direkt verwenden:

for (auto it : QStringTokenizer{string, separator})
    use(*it);

auto result = strview.tokenize(sep);

Der Grund dafür ist, dass die Template-Argumente von `QStringTokenizer` eine sehr subtile Abhängigkeit von den spezifischen String- und Trennzeichen-Typen aufweisen, aus denen sie konstruiert werden, und dass sie in der Regel nicht den tatsächlich übergebenen Typen entsprechen.

Lazy-Sequenzen

QStringTokenizer verhält sich wie eine sogenannte „lazy sequence“, d. h., jedes nächste Element wird erst berechnet, wenn Sie es anfordern. Lazy Sequences haben den Vorteil, dass sie nur O(1)-Speicherplatz benötigen. Ihr Nachteil ist, dass sie – zumindest bei QStringTokenizer – nur eine vorwärtsgerichtete Iteration zulassen, keinen wahlfreien Zugriff.

Der vorgesehene Anwendungsfall ist, dass man sie einfach in eine for-Schleife mit Bereichsangabe einbindet:

for (auto it : QStringTokenizer{string, separator})
    use(*it);

oder in einen C++20-Bereichsalgorithmus:

std::ranges::for_each(QStringTokenizer{string, separator},
                      [] (auto token) { use(token); });

End-Sentinel

Die Iteratoren von QStringTokenizer können nicht mit klassischen STL-Algorithmen verwendet werden, da diese Iterator-/Iterator-Paare erfordern, während QStringTokenizer Sentinel-Werte verwendet. Das heißt, es verwendet einen anderen Typ, QStringTokenizer::sentinel, um das Ende des Bereichs zu markieren. Dies verbessert die Leistung, da der Sentinel ein leerer Typ ist. Sentinels werden ab C++17 (für „ranged for“) und C++20 (für Algorithmen, die die neue Ranges-Bibliothek verwenden) unterstützt.

Temporäre Variablen

QStringTokenizer wurde sehr sorgfältig entwickelt, um hängende Referenzen zu vermeiden. Wenn Sie einen Tokenizer aus einer temporären Zeichenkette (einem r-Wert) erstellen, wird dieses Argument intern gespeichert, sodass die referenzierten Daten nicht gelöscht werden, bevor sie tokenisiert werden:

auto tok = QStringTokenizer{widget.text(), u','};
// return value of `widget.text()` is destroyed, but content was moved into `tok`
for (auto e : tok)
   use(e);

Wenn Sie benannte Objekte (L-Werte) übergeben, speichert QStringTokenizer keine Kopie. Sie sind dafür verantwortlich, die Daten des benannten Objekts länger aufrechtzuerhalten, als der Tokenizer darauf zugreift:

auto text = widget.text();
auto tok = QStringTokenizer{text, u','};
text.clear();      // destroy content of `text`
for (auto e : tok) // ERROR: `tok` references deleted data!
    use(e);