close
名前空間
変種

    std::destroy_at

    提供: cppreference.com
     
    C++
     
    ユーティリティライブラリ
    汎用ユーティリティ
    日付と時間
    関数オブジェクト
    書式化ライブラリ (C++20)
    (C++11)
    (C++14)
    関係演算子 (C++20で非推奨)
    整数比較関数
    (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
    (C++20)
    スワップと型操作
    (C++20)
    (C++14)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++17)
    一般的な語彙の型
    (C++11)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)

    初等文字列変換
    (C++17)
    (C++17)
    (C++17)
     
    動的メモリ管理
    スマートポインタ
    (C++11)
    (C++11)
    (C++11)
    (C++17未満)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    アロケータ
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++20)
    (C++20)
    (C++20)
    (C++11)
    (C++17)
    メモリリソース
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    (C++17)
    未初期化記憶域
    (C++20未満)
    (C++20未満)
    (C++20未満)
    ガベージコレクションサポート
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    (C++11)
    その他
    (C++11)
    (C++20)
    (C++11)
    (C++11)
    (C++20)
    C のライブラリ
    低水準のメモリ管理
     
    <tbody> </tbody>
    ヘッダ <memory> で定義
    template< class T > void destroy_at( T* p );
    		 (C++17以上)

    p->~T() によって行われたかのように、 p の指すオブジェクトのデストラクタを呼びます。

    引数

    p - 破棄するオブジェクトを指すポインタ

    戻り値

    (なし)

    実装例

    template<class T>
void destroy_at(T* p) 
{ 
    p->~T(); 
}

    例

    以下の例は隣接する一連の要素を破棄するために destroy_at を使用する方法をデモンストレーションします。

    Run this code
    #include <memory>
#include <new>
#include <iostream>

struct Tracer {
    int value;
    ~Tracer() { std::cout << value << " destructed\n"; }
};

int main()
{
    alignas(Tracer) unsigned char buffer[sizeof(Tracer) * 8];
    
    for (int i = 0; i < 8; ++i)
        new(buffer + sizeof(Tracer) * i) Tracer{i}; //manually construct objects

    auto ptr = std::launder(reinterpret_cast<Tracer*>(buffer));

    for (int i = 0; i < 8; ++i)
        std::destroy_at(ptr + i);

}

    出力: 

    0 destructed
1 destructed
2 destructed
3 destructed
4 destructed
5 destructed
6 destructed
7 destructed

    関連項目

    (C++17)
    		 指定範囲のオブジェクトを破棄します
    (関数テンプレート) [edit]
    (C++17)
    		 指定個数のオブジェクトを破棄します
    (関数テンプレート) [edit]