QStringTokenizer Class

Description détaillée

QStringTokenizer<Haystack, Needle> est une classe de modèle où Haystack correspond au type de la chaîne à tokeniser et Needle au type du séparateur. En pratique, vous ne devriez jamais avoir besoin de spécifier explicitement ces arguments de modèle ; ils sont déduits automatiquement par le compilateur.

Divise une chaîne en sous-chaînes à chaque occurrence d’un séparateur donné, et renvoie une liste (construite de manière différée) de ces sous-chaînes. Si le séparateur ne correspond à aucun élément de la chaîne, il produit une liste à un seul élément contenant cette chaîne. Si le séparateur est vide, QStringTokenizer produit une chaîne vide, suivie de chacun des caractères de la chaîne, puis d’une autre chaîne vide. Les deux énumérations Qt::SplitBehavior et Qt::CaseSensitivity permettent de contrôler davantage le résultat.

QStringTokenizer utilise QStringView::tokenize(), mais vous pouvez également l'utiliser directement :

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

auto result = strview.tokenize(sep);

En effet, les arguments de modèle de QStringTokenizer présentent une dépendance très subtile vis-à-vis des types spécifiques de chaînes et de séparateurs à partir desquels ils sont construits, et ils ne correspondent généralement pas aux types réels passés en paramètre.

Séquences paresseuses

QStringTokenizer se comporte comme ce qu’on appelle une « séquence paresseuse », c’est-à-dire que chaque élément suivant n’est calculé qu’au moment où vous le demandez. Les séquences paresseuses présentent l’avantage de ne nécessiter qu’O(1) de mémoire. Elles ont pour inconvénient, du moins dans le cas de QStringTokenizer, de ne permettre qu’une itération vers l’avant, et non un accès aléatoire.

Le cas d'utilisation prévu consiste simplement à l'intégrer dans une boucle « for » avec une plage :

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

ou dans un algorithme de plage C++20 :

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

Sentinelle de fin

Les itérateurs de QStringTokenizer ne peuvent pas être utilisés avec les algorithmes STL classiques, car ceux-ci requièrent des paires itérateur/itérateur, tandis que QStringTokenizer utilise des sentinelles. Autrement dit, il utilise un type différent, QStringTokenizer::sentinel, pour marquer la fin de la plage. Cela améliore les performances, car la sentinelle est un type vide. Les sentinelles sont prises en charge à partir de C++17 (pour les boucles « for » sur des plages) et de C++20 (pour les algorithmes utilisant la nouvelle bibliothèque de plages).

Variables temporaires

QStringTokenizer est conçu avec le plus grand soin pour éviter les références pendantes. Si vous créez un tokenizer à partir d’une chaîne temporaire (une rvalue), cet argument est stocké en interne, de sorte que les données référencées ne sont pas supprimées avant d’être tokenisées :

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

Si vous passez des objets nommés (l-values), QStringTokenizer n’en stocke pas de copie. Il vous incombe de conserver les données de l’objet nommé plus longtemps que la durée pendant laquelle le tokenizer les traite :

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