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 をこのオブジェクトに代入し、コピーへの参照を返します。