std::destroy_at(C++17)

namespace std {
  template <class T>
  void destroy_at(T* location);           // (1) C++17

  template <class T>
  constexpr void destroy_at(T* location); // (1) C++20
}

概要

デストラクタを呼び出す。

この関数は、配置newで構築したオブジェクトを破棄するために使用する。

効果

型Tが配列型である場合、以下と等価：
```
destroy(begin(*location), end(*location));
```
そうでない場合、以下と等価：
```
location->~T();
```

備考

非トリビアルなデストラクタをもたないintやchar配列のような型のオブジェクトに対しては、デストラクタを呼び出す必要はない。std::is_trivially_destructible_v<T> == trueな型に対しては、なにもしない最適化が行われる可能性がある
- 例として、std::optionalクラスのデストラクタ、およびstd::vectorクラスのデストラクタを参照

例

#include <iostream>
#include <memory>

int main()
{
  // 配置newでオブジェクトを構築
  char storage[4];
  int* n = new(storage) int;

  *n = 314;
  std::cout << *n << std::endl;

  // デストラクタを呼び出して破棄
  std::destroy_at(n);
}

std::destroy_at(C++17)

概要

効果

備考

例

出力

バージョン

言語

処理系

関連項目

参照