QStringTokenizer Class

Documentation des fonctions membres

Construit un tokenizer de chaîne qui divise la chaîne haystack en sous-chaînes à chaque fois que needle apparaît, et permet l'itération sur ces chaînes au fur et à mesure qu'elles sont trouvées. Si needle ne correspond à aucun élément de haystack, un seul élément contenant haystack est produit.

cs spécifie si needle doit être traité en tenant compte de la casse ou non.

Si sb est Qt::SkipEmptyParts, les entrées vides n'apparaissent pas dans le résultat. Par défaut, les entrées vides sont incluses.

Voir aussi QStringView::split(), QString::split(), Qt::CaseSensitivity, et Qt::SplitBehavior.

Renvoie un itérateur constant de style STL pointant sur le premier élément de la liste.

Voir aussi end() et cend().

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

Identique à end().

Voir également cbegin() et end().

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

Renvoie une sentinelle constante de style STL pointant vers le jeton imaginaire situé après le dernier jeton de la liste.

Voir aussi begin() et cend().

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

Convertit la séquence paresseuse en un conteneur (typiquement) à accès aléatoire de type LContainer.

Cette fonction n'est disponible que si Container a un value_type correspondant à ce tokenizer value_type.

Si vous passez un conteneur nommé (une valeur l) pour c, alors ce conteneur est rempli et une référence à celui-ci est renvoyée. Si vous passez un conteneur temporaire (une rvalue, y compris l'argument par défaut), alors ce conteneur est rempli et retourné par sa valeur.

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

Cela vous donne un maximum de flexibilité dans la manière dont vous souhaitez stocker la séquence.

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

Convertit la séquence paresseuse en un conteneur (typiquement) à accès aléatoire de type RContainer.

En plus des contraintes de la surcharge lvalue-this, cette surcharge rvalue-this n'est disponible que si QStringTokenizer ne stocke pas la botte de foin en interne, car cela pourrait créer un conteneur plein de références pendantes :

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

Pour y remédier, stockez le site QStringTokenizer dans un répertoire temporaire :

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.

Vous pouvez forcer l'existence de cette fonction en lui passant une vue à la place :

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

Si vous passez un conteneur nommé (une lvalue) pour c, alors ce conteneur est rempli et une référence à celui-ci est renvoyée. Si vous passez un conteneur temporaire (une valeur r, y compris l'argument par défaut), ce conteneur est rempli et renvoyé par sa valeur.