QRegularExpressionMatch Class

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

QRegularExpressionMatch::QRegularExpressionMatch()

有効な空の QRegularExpressionMatch オブジェクトを生成します。正規表現はデフォルトのコンストラクタで生成されたものが設定され、マッチタイプは `QRegularExpression::NoMatch `、マッチオプションは `QRegularExpression::NoMatchOption` に設定されます。

このオブジェクトは、hasMatch() およびhasPartialMatch() メンバー関数を通じて、一致がないことを報告します。

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

指定されたmatch の結果をコピーして、マッチ結果を生成します。

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

[constexpr noexcept default, since 6.1] QRegularExpressionMatch::QRegularExpressionMatch(QRegularExpressionMatch &&match)

指定されたmatch から結果を移動して、マッチ結果を構築します。

なお、移動元の QRegularExpressionMatch に対しては、破棄または代入のみが可能です。デストラクタや代入演算子以外の関数を呼び出した場合の結果は未定義となります。

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

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

[noexcept] QRegularExpressionMatch::~QRegularExpressionMatch()

試合結果を無効にします。

QString QRegularExpressionMatch::captured(QAnyStringView name) const

name という名前のキャプチャグループによってキャプチャされた部分文字列を返します。

名前付きキャプチャグループ `name ` が文字列をキャプチャしなかった場合、または `name` という名前のキャプチャグループが存在しない場合は、ヌル `QString` を返します。

関連項目： capturedView()、capturedStart()、capturedEnd()、capturedLength()、およびQString::isNull()。

QString QRegularExpressionMatch::captured(int nth = 0) const

nth キャプチャグループによってキャプチャされた部分文字列を返します。

nth キャプチャグループが文字列をキャプチャしなかった場合、またはそのようなキャプチャグループが存在しない場合は、null（QString ）を返します。

関連項目： capturedView()、lastCapturedIndex()、capturedStart()、capturedEnd()、capturedLength()、およびQString::isNull()。

qsizetype QRegularExpressionMatch::capturedEnd(QAnyStringView name) const

name という名前のキャプチャグループによってキャプチャされた部分文字列の終了位置の直後の、対象文字列内のオフセットを返します。name という名前のキャプチャグループが文字列をキャプチャしなかった場合、またはそのキャプチャグループが存在しない場合は、-1 を返します。

関連項目： capturedStart()、capturedLength()、およびcaptured()。

qsizetype QRegularExpressionMatch::capturedEnd(int nth = 0) const

nth キャプチャグループによってキャプチャされた部分文字列の終了位置の直後の、対象文字列内のオフセットを返します。nth キャプチャグループが文字列をキャプチャしなかった場合、または存在しない場合は、-1 を返します。

関連項目： capturedStart()、capturedLength()、captured()。

qsizetype QRegularExpressionMatch::capturedLength(QAnyStringView name) const

name という名前のキャプチャグループによってキャプチャされた部分文字列の長さを返します。

関連項目： capturedStart()、capturedEnd()、およびcaptured()を参照してください 。

qsizetype QRegularExpressionMatch::capturedLength(int nth = 0) const

nth キャプチャグループによってキャプチャされた部分文字列の長さを返します。

関連項目： capturedStart()、capturedEnd()、captured()。

qsizetype QRegularExpressionMatch::capturedStart(QAnyStringView name) const

name という名前のキャプチャグループによってキャプチャされた部分文字列の開始位置に対応する、対象文字列内のオフセットを返します。name という名前のキャプチャグループが文字列をキャプチャしなかった場合、またはそのキャプチャグループが存在しない場合は、-1 を返します。

関連項目： capturedEnd()、capturedLength()、およびcaptured()。

qsizetype QRegularExpressionMatch::capturedStart(int nth = 0) const

nth キャプチャグループによってキャプチャされた部分文字列の開始位置に対応する、対象文字列内のオフセットを返します。nth キャプチャグループが文字列をキャプチャしなかった場合、または存在しない場合は、-1 を返します。

関連項目: ` capturedEnd()`、`capturedLength()`、および `captured()`。

QStringList QRegularExpressionMatch::capturedTexts() const

キャプチャグループによってキャプチャされたすべての文字列のリストを、パターン文字列内でのグループの出現順に返します。このリストには、パターン全体と一致した部分文字列をキャプチャする暗黙のキャプチャグループ（番号 0）も含まれます。

QStringView QRegularExpressionMatch::capturedView(QAnyStringView name) const

「name 」という名前のキャプチャグループによってキャプチャされた文字列のビューを返します。

名前付きキャプチャグループ `name ` が文字列をキャプチャしなかった場合、または `name` という名前のキャプチャグループが存在しない場合は、null `QStringView` を返します。

関連項目： captured()、capturedStart()、capturedEnd()、capturedLength()、およびQStringView::isNull()。

QStringView QRegularExpressionMatch::capturedView(int nth = 0) const

nth キャプチャグループによってキャプチャされた部分文字列のビューを返します。

nth のキャプチャグループが文字列をキャプチャしなかった場合、またはそのようなキャプチャグループが存在しない場合は、nullのQStringView を返します。

関連項目： captured()、lastCapturedIndex()、capturedStart()、capturedEnd()、capturedLength()、およびQStringView::isNull()を参照してください 。

[since 6.3] bool QRegularExpressionMatch::hasCaptured(QAnyStringView name) const

name という名前のキャプチャグループが対象文字列内で何かをキャプチャした場合は true を返し、そうでない場合（またはname という名前のキャプチャグループが存在しない場合）は false を返します。

QRegularExpression re("([a-z]+)|([A-Z]+)");
QRegularExpressionMatch m=re.match("UPPERCASE");
if(m.hasMatch()) {
    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

同様に、キャプチャグループは長さ 0 の部分文字列をキャプチャする場合もあります。この関数は、そのようなキャプチャグループに対してtrue を返します。

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

captured() およびhasMatch()も参照してください 。

[since 6.3] bool QRegularExpressionMatch::hasCaptured(int nth) const

nth キャプチャグループが subject 文字列内で何かをキャプチャした場合、true を返し、それ以外の場合（またはそのようなキャプチャグループが存在しない場合）は false を返します。

QRegularExpression re("([a-z]+)|([A-Z]+)");
QRegularExpressionMatch m=re.match("UPPERCASE");
if(m.hasMatch()) {
    qDebug() << m.hasCaptured(0); // true
    qDebug() << m.hasCaptured(1); // false
    qDebug() << m.hasCaptured(2); // true
}

同様に、キャプチャグループは長さ 0 の部分文字列をキャプチャする場合もあります。この関数は、そのようなキャプチャグループに対してtrue を返します。

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

captured()、lastCapturedIndex()、およびhasMatch()も参照してください 。

bool QRegularExpressionMatch::hasMatch() const

正規表現が対象の文字列と一致した場合は `true ` を返し、一致しなかった場合は `false` を返します。

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

bool QRegularExpressionMatch::hasPartialMatch() const

正規表現が対象文字列と部分一致した場合は `true ` を返し、それ以外の場合は `false` を返します。

関連項目: QRegularExpression::match()、QRegularExpression::MatchType 、およびhasMatch()。

bool QRegularExpressionMatch::isValid() const

有効なQRegularExpression オブジェクトに対してQRegularExpression::match()関数が呼び出され、その結果としてmatchオブジェクトが取得された場合はtrue を返します。QRegularExpression が無効だった場合はfalse を返します。

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

int QRegularExpressionMatch::lastCapturedIndex() const

何かをキャプチャした最後のキャプチャグループのインデックスを返します。これには、暗黙のキャプチャグループ 0 も含まれます。これを使用して、キャプチャされたすべての部分文字列を抽出することができます：

QRegularExpressionMatch match = re.match(string);
for (int i = 0; i <= match.lastCapturedIndex(); ++i) {
    QString captured = match.captured(i);
    // ...
}

なお、lastCapturedIndex() より小さいインデックスを持つキャプチャグループの中には、一致しなかったために何もキャプチャしていないものがある可能性があることに注意してください。

正規表現が一致しなかった場合、この関数は -1 を返します。

関連項目： hasCaptured()、captured()、capturedStart()、capturedEnd()、およびcapturedLength()。

QRegularExpression::MatchOptions QRegularExpressionMatch::matchOptions() const

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

QRegularExpression::match()、regularExpression()、およびmatchType()も参照してください 。

QRegularExpression::MatchType QRegularExpressionMatch::matchType() const

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

QRegularExpression::match()、regularExpression()、およびmatchOptions()も参照してください 。

QRegularExpression QRegularExpressionMatch::regularExpression() const

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

QRegularExpression::match()、matchType()、およびmatchOptions()も参照してください 。

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

この試合の結果をother と入れ替えます。この操作は非常に高速で、失敗することはありません。

[noexcept] QRegularExpressionMatch &QRegularExpressionMatch::operator=(QRegularExpressionMatch &&match)

match のマッチ結果をこのオブジェクトにコピー代入し、その結果への参照を返します。

なお、移動元の `QRegularExpressionMatch ` に対しては、破棄するか、代入を行うことしかできません。デストラクタや代入演算子以外の関数を呼び出した場合の効果は未定義です。

QRegularExpressionMatch &QRegularExpressionMatch::operator=(const QRegularExpressionMatch &match)

このオブジェクトに試合結果match を割り当て、そのコピーへの参照を返します。