最終更新日時: 2024年06月11日 22時45分38秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<regex>

# std::match_results::cbegin(C++11)

    const_iterator cbegin() const;

## 概要

`*this` 内の全てのサブマッチを列挙するため、先頭のサブマッチを指すイテレータを返す。

## 戻り値

先頭のサブマッチを指すイテレータ

## 備考

- 「先頭のサブマッチ」は、正規表現にマッチした文字列全体を指す。
- 本メンバ関数で返されるイテレータは、`begin` で返されるイテレータと型も含め完全に同一である。

## 例

    #include <iostream>
    #include <regex>

    int main()
    {
      const char s[] = " abc 0123 defgh ";
      const std::regex re("(\\w+) (\\d+) (\\w+)");

      std::cmatch m;
      if (std::regex_search(s, m, re)) {
        for (auto it = m.cbegin(), end = m.cend(); it != end; ++it) {
          std::cout << "str() = '" << it->str() << "', "
            "range = [" << it->first - s << ", " << it->second - s << "), "
            "matched = " << std::boolalpha << it->matched << std::endl;
        }
      } else {
        std::cout << "not match" << std::endl;
      }
    }

### 出力

    str() = 'abc 0123 defgh', range = [1, 15), matched = true
    str() = 'abc', range = [1, 4), matched = true
    str() = '0123', range = [5, 9), matched = true
    str() = 'defgh', range = [10, 15), matched = true

## バージョン

### 言語

- C++11

### 処理系

- Clang: 3.0 ✅, 3.1 ✅, 3.2 ✅, 3.3 ✅, 3.4 ✅, 3.5 ✅, 3.6 ✅
- GCC: 4.9.0 ✅, 4.9.1 ✅, 5.0.0 ✅
- ICC: ??
- Visual C++: ??

### 備考

GCC(libstdc++) のバージョン 4.9.2 までは、`cbegin` が誤ったイテレータを返す。これは 4.9.3 以降で修正される予定である。