• Class / Function / Type

      std::
    • Header file

      <>
    • Other / All

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

    履歴 編集

    function
    <regex>

    std::match_results::ready

    bool ready() const;
    

    概要

    マッチ結果が利用可能か否かを返す。

    戻り値

    マッチ結果が利用可能である場合 true、利用可能ではない場合 false

    備考

    • regex_match、および、regex_search の引数に渡した match_results オブジェクトは、マッチが成功しなくても ready() == true となる。
      match_results オブジェクトでマッチが成功したか否かを確認する場合には、regex_match、および、regex_search の戻り値を使用するか、empty を使用すると良い。
    • regex_iterator を間接参照して得られる match_results オブジェクトは、必ず ready() == true となる。
    • ready() != true の場合、match_results のほとんどのメンバ関数は使用できないため、注意が必要である(各メンバ関数の「要件」を参照)。

    #include <iostream>
    #include <regex>
    
    int main()
    {
      const char s1[] = " abc ";
      const char s2[] = " 012 ";
      const std::regex re("\\d+");
    
      std::cmatch m;
      // regex_search 実行前
      std::cout << std::boolalpha << "ready = " << m.ready() << ", empty = " << m.empty() << std::endl;
    
      // regex_search 実行後(マッチ失敗)
      if (std::regex_search(s1, m, re)) {
        std::cout << "match:ready = " << m.ready() << ", empty = " << m.empty() << std::endl;
      } else {
        std::cout << "not match:ready = " << m.ready() << ", empty = " << m.empty() << std::endl;
      }
    
      // regex_search 実行後(マッチ成功)
      if (std::regex_search(s2, m, re)) {
        std::cout << "match:ready = " << m.ready() << ", empty = " << m.empty() << std::endl;
      } else {
        std::cout << "not match:ready = " << m.ready() << ", empty = " << m.empty() << std::endl;
      }
    }
    

    出力

    ready = false, empty = true
    not match:ready = true, empty = true
    match:ready = true, empty = false
    

    バージョン

    言語

    • 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++: ??