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;
}
}
xxxxxxxxxx
#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++: ??