QRegularExpressionMatchIterator Class

// extracts the words
QRegularExpression re("(\\w+)");
QString subject("the quick fox");
QRegularExpressionMatchIterator i = re.globalMatch(subject);
while (i.hasNext()) {
    QRegularExpressionMatch match = i.next();
    // ...
}

// using a raw string literal, R"(raw_characters)", to be able to use "\w"
// without having to escape the backslash as "\\w"
QRegularExpression re(R"(\w+)");
QString subject("the quick fox");
for (const QRegularExpressionMatch &match : re.globalMatch(subject)) {
    // ...
}

Documentation sur les fonctions membres

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

Construit un objet `QRegularExpressionMatchIterator` vide et valide. L'expression régulière est définie sur celle générée par défaut ; le type de correspondance est ` QRegularExpression::NoMatch ` et les options de correspondance sont ` QRegularExpression::NoMatchOption`.

L'appel de la fonction membre ` hasNext()` sur l'objet créé renverra `false`, car l'itérateur ne parcourt pas une séquence valide de correspondances.

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

Crée un objet `QRegularExpressionMatchIterator` en tant que copie de ` iterator`.

Voir également operator=().

[constexpr noexcept default, since 6.1] QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(QRegularExpressionMatchIterator &&iterator)

Construit un objet `QRegularExpressionMatchIterator` à partir d'un ` iterator`.

Notez qu'un objet QRegularExpressionMatchIterator issu d'un déplacement ne peut être que détruit ou affecté. L'effet de l'appel à des fonctions autres que le destructeur ou l'un des opérateurs d'affectation est indéfini.

Cette fonction a été introduite dans Qt 6.1.

Voir également operator=().

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

Supprime l'objet « QRegularExpressionMatchIterator ».

bool QRegularExpressionMatchIterator::hasNext() const

Renvoie « true » s'il existe au moins un résultat de correspondance avant l'itérateur ; sinon, elle renvoie « false ».

Voir également next().

bool QRegularExpressionMatchIterator::isValid() const

Renvoie true si l'objet itérateur a été obtenu à la suite de l'appel de la fonction QRegularExpression::globalMatch() sur un objet QRegularExpression valide ; renvoie false si l'appel de QRegularExpression était invalide.

Voir également QRegularExpression::globalMatch() et QRegularExpression::isValid().

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

Renvoie les options de correspondance utilisées pour obtenir cet objet ` QRegularExpressionMatchIterator `, c'est-à-dire les options de correspondance transmises à la fonction ` QRegularExpression::globalMatch()`.

Voir également QRegularExpression::globalMatch(), regularExpression() et matchType().

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

Renvoie le type de correspondance utilisé pour obtenir cet objet ` QRegularExpressionMatchIterator `, c'est-à-dire le type de correspondance qui a été transmis à la fonction ` QRegularExpression::globalMatch()`.

Voir également QRegularExpression::globalMatch(), regularExpression() et matchOptions().

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

Renvoie le résultat suivant de la recherche et fait avancer l'itérateur d'une position.

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

Renvoie le résultat suivant de la recherche sans déplacer l'itérateur.

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

Renvoie l'objet ` QRegularExpression ` dont la fonction `globalMatch()` a renvoyé cet objet.

Voir également QRegularExpression::globalMatch(), matchType() et matchOptions().

[noexcept] void QRegularExpressionMatchIterator::swap(QRegularExpressionMatchIterator &other)

Permute cet itérateur avec other. Cette opération est très rapide et ne rencontre jamais d'échec.

[noexcept] QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(QRegularExpressionMatchIterator &&iterator)

La fonction « move-assign » attribue l'iterator à cet objet et renvoie une référence au résultat.

Notez qu’un ` QRegularExpressionMatchIterator ` déplacé ne peut être que détruit ou affecté. L’effet de l’appel à d’autres fonctions que le destructeur ou l’un des opérateurs d’affectation est indéfini.

QRegularExpressionMatchIterator &QRegularExpressionMatchIterator::operator=(const QRegularExpressionMatchIterator &iterator)

Attribue l'iterator d'itérateur à cet objet et renvoie une référence à la copie.