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)) {
    // ...
}

Dokumentation zu den Mitgliedsfunktionen

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

Erstellt ein leeres, gültiges `QRegularExpressionMatchIterator`-Objekt. Der reguläre Ausdruck wird auf den Standardwert gesetzt; der Übereinstimmungstyp auf ` QRegularExpression::NoMatch ` und die Übereinstimmungsoptionen auf ` QRegularExpression::NoMatchOption`.

Der Aufruf der Memberfunktion ` hasNext()` für das erstellte Objekt gibt `false` zurück, da der Iterator nicht über eine gültige Abfolge von Übereinstimmungen iteriert.

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

Erstellt ein `QRegularExpressionMatchIterator`-Objekt als Kopie von ` iterator`.

Siehe auch ` operator=()`.

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

Erstellt ein `QRegularExpressionMatchIterator`-Objekt, indem es von ` iterator` verschoben wird.

Beachten Sie, dass ein verschobener `QRegularExpressionMatchIterator` nur zerstört oder zugewiesen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch ` operator=()`.

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

Löscht das Objekt „ QRegularExpressionMatchIterator “.

bool QRegularExpressionMatchIterator::hasNext() const

Gibt „ true “ zurück, wenn vor dem Iterator mindestens ein Treffer vorliegt; andernfalls wird „ false “ zurückgegeben.

Siehe auch next().

bool QRegularExpressionMatchIterator::isValid() const

Gibt „ true “ zurück, wenn das Iterator-Objekt als Ergebnis der Funktion „ QRegularExpression::globalMatch()“ erhalten wurde, die für ein gültiges „ QRegularExpression “-Objekt aufgerufen wurde; gibt „ false “ zurück, wenn das „ QRegularExpression “ ungültig war.

Siehe auch „ QRegularExpression::globalMatch()“ und „ QRegularExpression::isValid()“.

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

Gibt die Match-Optionen zurück, die zum Abrufen dieses QRegularExpressionMatchIterator -Objekts verwendet wurden, d. h. die Match-Optionen, die an QRegularExpression::globalMatch() übergeben wurden.

Siehe auch QRegularExpression::globalMatch(), regularExpression() und matchType().

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

Gibt den Match-Typ zurück, der zum Abrufen dieses QRegularExpressionMatchIterator -Objekts verwendet wurde, d. h. den Match-Typ, der an QRegularExpression::globalMatch() übergeben wurde.

Siehe auch QRegularExpression::globalMatch(), regularExpression() und matchOptions().

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

Gibt das nächste Trefferergebnis zurück und verschiebt den Iterator um eine Position weiter.

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

Gibt das nächste Trefferergebnis zurück, ohne den Iterator zu verschieben.

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

Gibt das „ QRegularExpression “-Objekt zurück, dessen Funktion „globalMatch()“ dieses Objekt zurückgegeben hat.

Siehe auch „ QRegularExpression::globalMatch()“, „ matchType()“ und „ matchOptions()“.

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

Tauscht diesen Iterator mit other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

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

„move“ weist dem Objekt iterator zu und gibt eine Referenz auf das Ergebnis zurück.

Beachten Sie, dass ein verschobenes ` QRegularExpressionMatchIterator ` nur zerstört oder einer Zuweisung unterzogen werden kann. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.

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

Weist diesem Objekt den Iterator „ iterator “ zu und gibt eine Referenz auf die Kopie zurück.