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 という名前のキャプチャグループが件名文字列の何かをキャプチャした場合は真を、そうでない場合 (またはname というキャプチャグループが存在しない場合) は偽を返します。

QRegularExpressionre("([a-z]+)|([A-Z]+)");QRegularExpressionMatchm=re.match("UPPERCASE");if(m.hasMatch()) { { 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 のキャプチャグループが件名文字列の何かをキャプチャした場合は true を返し、そうでない場合 (またはそのようなキャプチャグループがない場合) は false を返します。

QRegularExpressionre("([a-z]+)|([A-Z]+)");QRegularExpressionMatchm=re.match("UPPERCASE");if(m.hasMatch()) { { 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 を割り当て、そのコピーへの参照を返します。