最終更新日時: 2025年02月27日 15時55分09秒 (JST)
Akira Takahashi が更新

履歴 編集

function
<regex>

# std::match_results::empty(C++11)

    bool empty() const;               // (1) C++11
    [[nodiscard]] bool empty() const; // (1) C++20
    bool empty() const;               // (1) C++26

## 概要

`*this` が空か否か（つまり、マッチが失敗したか否か）を返す。

## 戻り値

`size() == 0`

## 備考

- `regex_match`、および、`regex_search` の引数に渡した `match_results` オブジェクトは、マッチが成功すると `empty() != true` となる。
  `match_results` オブジェクトの結果が利用可能か否かを確認する場合には `ready` を使用すると良い。
- `regex_iterator` を間接参照して得られる `match_results` オブジェクトは、必ず `empty() != true` となる。
- `empty() == true` の場合、`match_results` のメンバ関数には結果が未規定であるものがあるので、注意が必要である（`regex_match`、および、`regex_search` を参照）。
- 本メンバ関数は `ready() == false` でも呼び出すことが可能である（その場合、`true` が返される）。

## 例

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

## 参照

- P0600R1 `[[nodiscard]]` in the Library
  - C++20で`[[nodiscard]]`が付加された
- P2422R1 Remove `nodiscard` annotations from the standard library specification
  - C++26で`[[nodiscard]]`指定が削除された