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)

iterator のコピーとして、QRegularExpressionMatchIterator オブジェクトを生成します。

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

[constexpr noexcept default, 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)

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

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

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

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