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 des fonctions membres

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

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

L'invocation de la fonction membre hasNext() sur l'objet construit renverra un faux, car l'itérateur n'est pas en train d'itérer sur une séquence valide de correspondances.

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

Construit un objet QRegularExpressionMatchIterator en tant que copie de iterator.

Voir aussi operator=().

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

Construit un objet QRegularExpressionMatchIterator en le déplaçant de iterator.

Notez qu'un QRegularExpressionMatchIterator déplacé à partir d'un objet ne peut être que détruit ou assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

Cette fonction a été introduite dans Qt 6.1.

Voir aussi operator=().

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

Détruit l'objet QRegularExpressionMatchIterator.

bool QRegularExpressionMatchIterator::hasNext() const

Renvoie true s'il y a au moins un résultat de correspondance avant l'itérateur ; sinon, il renvoie false.

Voir aussi next().

bool QRegularExpressionMatchIterator::isValid() const

Renvoie true si l'objet itérateur a été obtenu comme résultat de la fonction QRegularExpression::globalMatch() invoquée sur un objet QRegularExpression valide ; renvoie false si le QRegularExpression n'était pas valide.

Voir aussi QRegularExpression::globalMatch() et QRegularExpression::isValid().

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

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

Voir aussi 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 transmis à QRegularExpression::globalMatch().

Voir aussi QRegularExpression::globalMatch(), regularExpression() et matchOptions().

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

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

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

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

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

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

Voir aussi QRegularExpression::globalMatch(), matchType(), et matchOptions().

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

Échange cet itérateur avec other. Cette opération est très rapide et n'échoue jamais.

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

Move assigne l'objet 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 assigné. L'effet de l'appel à d'autres fonctions que le destructeur ou l'un des opérateurs d'affectation n'est pas défini.

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

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