• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

    最終更新日時(UTC):
    が更新

    履歴 編集

    function
    <regex>

    std::match_results::cend

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

    出力

    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 までは、cend が誤ったイテレータを返す。これは 4.9.3 以降で修正される予定である。