cend.md

cend

• regex[meta header]
• std[meta namespace]
• match_results[meta class]
• function[meta id-type]
• cpp11[meta cpp]

const_iterator cend() const;

概要

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

戻り値

最後のサブマッチの次を指すイテレータ

備考

• 本メンバ関数で返されるイテレータは、end で返されるイテレータと型も含め完全に同一である。

例

#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;
  }
}

• cend()[color ff0000]
• std::regex[link ../basic_regex.md]
• std::cmatch[link ../match_results.md]
• std::regex_search[link ../regex_search.md]
• m.cbegin()[link cbegin.md]
• it->str()[link str.md]

出力

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 [mark verified], 3.1 [mark verified], 3.2 [mark verified], 3.3 [mark verified], 3.4 [mark verified], 3.5 [mark verified], 3.6 [mark verified]
• GCC: 4.9.0 [mark verified], 4.9.1 [mark verified], 5.0.0 [mark verified]
• ICC: ??
• Visual C++: ??

備考

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