QRegularExpressionMatch Class

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

QRegularExpressionMatch::QRegularExpressionMatch()

有効な空の QRegularExpressionMatch オブジェクトを構築します。マッチタイプはQRegularExpression::NoMatch に、マッチオプションはQRegularExpression::NoMatchOption に設定されます。

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

QRegularExpressionMatch::QRegularExpressionMatch(const QRegularExpressionMatch &match)

与えられたmatch の結果をコピーして、マッチ結果を構築します。

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

[noexcept, 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 という名前のキャプチャグループが存在しない場合、NULLQString を返します。

capturedView(),capturedStart(),capturedEnd(),capturedLength(),QString::isNull()も参照 。

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

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

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

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 という名前のキャプチャグループが存在しない場合は、NULLQStringView を返します。

captured(),capturedStart(),capturedEnd(),capturedLength(),QStringView::isNull()も参照 。

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

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

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

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() 関数を呼び出した結果、マッチオブジェクトが得られた場合は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)

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

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

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

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