std:: sub_match

クラステンプレート std::sub_match は、正規表現エンジンによってマークされた部分式に一致する文字シーケンスを表すために使用されます。 マッチは、正規表現に一致するターゲット範囲内の [ begin , end ) のペアですが、コードの明確性を高めるための追加のオブザーバ関数を備えています。

デフォルトコンストラクタのみが公開でアクセス可能です。 std::sub_match のインスタンスは通常、 std::match_results コンテナの一部として構築され、正規表現アルゴリズムの処理中に値が設定されます。

matched メンバーが true でない限り、メンバー関数は定義済みのデフォルト値を返します。

std::sub_match は std:: pair < BidirIt, BidirIt > から継承していますが、代入などのメンバ関数が期待通りに動作しないため、 std::pair オブジェクトとして扱うことはできません。

型要件

特殊化

一般的な文字シーケンス型に対するいくつかの特殊化が提供されています：

ネスト型

データメンバ

メンバー関数

非メンバー関数

例

#include <cassert>
#include <iostream>
#include <regex>
#include <string>
int main()
{
    std::string sentence{"Friday the thirteenth."};
    const std::regex re{"([A-z]+) ([a-z]+) ([a-z]+)"};
    std::smatch words;
    std::regex_search(sentence, words, re);
    std::cout << std::boolalpha;
    for (const auto& m : words)
    {
        assert(m.matched);
        std::cout << "m: [" << m << "], m.length(): " << m.length() << ", "
                     "*m.first: '" << *m.first << "', "
                     "*m.second: '" << *m.second << "'\n";
    }
}

m: [Friday the thirteenth], m.length(): 21, *m.first: 'F', *m.second: '.'
m: [Friday], m.length(): 6, *m.first: 'F', *m.second: ' '
m: [the], m.length(): 3, *m.first: 't', *m.second: ' '
m: [thirteenth], m.length(): 10, *m.first: 't', *m.second: '.'

関連項目