std::match_results::ready(C++11)

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

std::match_results::ready(C++11)

概要

戻り値

備考

例

出力

バージョン

言語

処理系