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

メンバ関数のドキュメント

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator()

空の有効な QRegularExpressionMatchIterator オブジェクトを構築します。正規表現にはデフォルトのものが設定され、マッチタイプにはQRegularExpression::NoMatch が、マッチオプションにはQRegularExpression::NoMatchOption が設定されます。

構築されたオブジェクトでhasNext() メンバ関数を呼び出すと、イテレータが有効なマッチのシーケンスで反復処理されていないため、false が返されます。

QRegularExpressionMatchIterator::QRegularExpressionMatchIterator(const QRegularExpressionMatchIterator &iterator)

QRegularExpressionMatchIterator オブジェクトをiterator のコピーとして構築します。

operator=()も参照してください 。

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

iterator から移動して QRegularExpressionMatchIterator オブジェクトを構築します。

移動元の QRegularExpressionMatchIterator は破棄または代入しかできないことに注意してください。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

この関数は Qt 6.1 で導入されました。

operator=()も参照してください 。

[noexcept] QRegularExpressionMatchIterator::~QRegularExpressionMatchIterator()

QRegularExpressionMatchIterator オブジェクトを破棄する。

bool QRegularExpressionMatchIterator::hasNext() const

イテレータの前に少なくとも1つのマッチ結果がある場合はtrue を返し、そうでない場合はfalse を返します。

next()も参照 。

bool QRegularExpressionMatchIterator::isValid() const

イテレータオブジェクトが、有効なQRegularExpression オブジェクトに対して呼び出されたQRegularExpression::globalMatch() 関数の結果として取得された場合はtrue を返し、QRegularExpression が無効な場合はfalse を返す。

QRegularExpression::globalMatch() およびQRegularExpression::isValid()も参照してください 。

QRegularExpression::MatchOptions QRegularExpressionMatchIterator::matchOptions() const

このQRegularExpressionMatchIterator オブジェクトを取得するために使用されたマッチオプション、つまりQRegularExpression::globalMatch() に渡されたマッチオプションを返します。

QRegularExpression::globalMatch()、regularExpression()、matchType()も参照 。

QRegularExpression::MatchType QRegularExpressionMatchIterator::matchType() const

このQRegularExpressionMatchIterator オブジェクトを取得するために使用されたマッチタイプ、つまりQRegularExpression::globalMatch() に渡されたマッチタイプを返します。

QRegularExpression::globalMatch()、regularExpression()、matchOptions()も参照 。

QRegularExpressionMatch QRegularExpressionMatchIterator::next()

次のマッチ結果を返し、イテレータを1つ進めます。

QRegularExpressionMatch QRegularExpressionMatchIterator::peekNext() const

イテレータを移動せずに、次のマッチ結果を返します。

QRegularExpression QRegularExpressionMatchIterator::regularExpression() const

globalMatch() 関数がこのオブジェクトを返したQRegularExpression オブジェクトを返します。

QRegularExpression::globalMatch()、matchType() およびmatchOptions()も参照 。

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

このイテレータをother と交換する。この操作は非常に高速で、失敗することはない。

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

Move-このオブジェクトにiterator を代入し、その結果への参照を返す。

移動されたQRegularExpressionMatchIterator は、破棄または代入しかできないことに注意。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

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

イテレータiterator をこのオブジェクトに割り当て、コピーへの参照を返します。