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 der Mitgliedsfunktionen

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

Konstruiert ein leeres, gültiges QRegularExpressionMatchIterator-Objekt. Der reguläre Ausdruck wird auf einen standardmäßig konstruierten Ausdruck gesetzt, der Übereinstimmungstyp auf QRegularExpression::NoMatch und die Übereinstimmungsoptionen auf QRegularExpression::NoMatchOption.

Der Aufruf der Memberfunktion hasNext() für das konstruierte Objekt gibt false zurück, da der Iterator nicht auf einer gültigen Folge von Übereinstimmungen iteriert.

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

Konstruiert ein QRegularExpressionMatchIterator-Objekt als Kopie von iterator.

Siehe auch operator=().

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

Konstruiert ein QRegularExpressionMatchIterator-Objekt durch Verschieben von iterator.

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

Diese Funktion wurde in Qt 6.1 eingeführt.

Siehe auch operator=().

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

Zerstört das Objekt QRegularExpressionMatchIterator.

bool QRegularExpressionMatchIterator::hasNext() const

Gibt true zurück, wenn mindestens ein Trefferergebnis vor dem Iterator liegt; 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 die Funktion QRegularExpression ungültig war.

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

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

Gibt die Übereinstimmungsoptionen zurück, die verwendet wurden, um dieses QRegularExpressionMatchIterator Objekt zu erhalten, d.h. die Übereinstimmungsoptionen, die an QRegularExpression::globalMatch() übergeben wurden.

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

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

Gibt den Übereinstimmungstyp zurück, der verwendet wurde, um dieses QRegularExpressionMatchIterator Objekt zu erhalten, d.h. den Übereinstimmungstyp, der an QRegularExpression::globalMatch() übergeben wurde.

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

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

Gibt das nächste Trefferergebnis zurück und rückt den Iterator um eine Position vor.

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

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

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

Gibt das Objekt QRegularExpression 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 nie fehl.

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

Move-zuweist das iterator diesem Objekt zu und gibt einen Verweis auf das Ergebnis zurück.

Beachten Sie, dass ein verschobenes QRegularExpressionMatchIterator nur zerstört oder zugewiesen 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.