最終更新日時(UTC): 2024年06月11日 13時45分38秒
Akira Takahashi が更新

履歴 編集

class template
<type_traits>

# std::is_empty(C++11)

    namespace std {
      template <class T>
      struct is_empty;

      template <class T>
      inline constexpr bool is_empty_v = is_empty<T>::value; // C++17
    }

## 概要

型`T`が空のクラスか調べる。

## 要件

型`T`が非共用体のクラスである場合、その型は完全型でなければならない。

## 効果

`is_empty`は、型`T`が空のクラス (cv修飾を許容する) であるならば`true_type`から派生し、そうでなければ`false_type`から派生する。

## 備考

空のクラスは、以下の条件を満たす型である。

- クラス型である。
- 共用型でない。
- 大きさ0のものを除いて、非静的メンバ変数を持たない。
- 仮想メンバ関数を持たない。
- 仮想基底クラスを持たない。
- 空のクラスでない基底クラスを持たない。

大きさ0のメンバ変数には、以下のものがある。

- 長さ0のビットフィールド
- 型が空のクラスであって、`[[no_unique_address]]`属性が指定されているメンバ (C++20)

## 例

    #include <type_traits>

    class empty_class{};
    struct non_empty_class {
      int m;                  // 非静的メンバ変数を持つ
    };

    static_assert(std::is_empty<empty_class>::value == true, "value == true, empty_class is empty");
    static_assert(std::is_same<std::is_empty<empty_class>::value_type, bool>::value, "value_type == bool");
    static_assert(std::is_same<std::is_empty<empty_class>::type, std::true_type>::value, "type == true_type");
    static_assert(std::is_empty<empty_class>() == true, "is_empty<empty_class>() == true");

    static_assert(std::is_empty<non_empty_class>::value == false, "value == false, non_empty_class is not empty");
    static_assert(std::is_same<std::is_empty<non_empty_class>::value_type, bool>::value, "value_type == bool");
    static_assert(std::is_same<std::is_empty<non_empty_class>::type, std::false_type>::value, "type == false_type");
    static_assert(std::is_empty<non_empty_class>() == false, "is_empty<non_empty_class>() == false");

    static_assert(std::is_empty<const volatile empty_class>::value == true, "const volatile empty_class is empty");
    static_assert(std::is_empty<empty_class&>::value == false, "empty_class& is not empty");

    int main(){}

### 出力

## バージョン

### 言語

- C++11

### 処理系

- GCC: 4.3.4 ✅, 4.5.3 ✅, 4.6.2 ✅, 4.7.0 ✅
- Visual C++: 2008 (std::tr1) ✅, 2010 ✅, 2012 ✅, 2013 ✅, 2015 ✅

#### 備考

上の例でコンパイラによってはエラーになる。GCC 4.3.4, 4.5.3, Visual C++ 2010 は `integral_constant` が `operator bool()` を持っていないためエラーになる。

## 関連項目

- `[[no_unique_address]]`属性

## 参照

- LWG Issue 2015. Incorrect pre-conditions for some type traits
  - C++11では要件が「型`T`は完全型であるか、`const`/`volatile`修飾された(あるいはされていない)`void`か、要素数不明の配列型でなければならない。」だったが、これは間違いであるため、C++14で「型`T`が非共用体のクラスである場合、その型は完全型でなければならない。」に変更された。
- P0006R0 Adopt Type Traits Variable Templates from Library Fundamentals TS for C++17