std::unique_ptr<T,Deleter>::~unique_ptr
From cppreference.com
< cpp | memory | unique ptr
C++
Feature test macros (C++20)
Concepts library (C++20)
Metaprogramming library (C++11)
Ranges library (C++20)
Filesystem library (C++17)
Concurrency support library (C++11)
Execution control library (C++26)
Memory management library
(exposition only*)
(C++11)
(C++23)
(C++11)
(C++17)
(C++11)
(C++11)
(C++20)
(C++20)
(C++17)
(C++11)
(C++17)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)
Uninitialized storage (until C++20)
(until C++20*)
(until C++20*)
(until C++20*)
Garbage collector support (until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)(until C++23)
(C++11)
(C++11)
(C++17)
(C++20)
(C++17)
(C++11)
(C++11)
(C++11)
(until C++17*)
(C++11)
(C++17)
(C++26)
(C++26)
(C++11)
(C++11)
(C++11)
(C++23)
(C++23)
(C++11)
(C++20)
(C++11)
(C++11)
(C++20)
(C++26)
std::unique_ptr
unique_ptr::~unique_ptr
(C++14)(C++20)
(until C++20)(C++20)
(C++20)
~unique_ptr();
(since C++11) (constexpr since C++23)
If get() ==
nullptr there are no effects. Otherwise, the owned object is destroyed via get_deleter() (
get() )
.
Requires that get_deleter()(get())
does not throw exceptions.
[edit] Notes
Although std::unique_ptr<T>
with the default deleter may be constructed with incomplete type T
, the type T
must be complete at the point of code where the destructor is called.
[edit] Example
The following program demonstrates usage of a custom deleter.
Run this code
#include <iostream> #include <memory> int main () { auto deleter = [](int* ptr) { std::cout << "[deleter called]\n"; delete ptr; }; std::unique_ptr <int, decltype(deleter)> uniq(new int, deleter); std::cout << (uniq ? "not empty\n" : "empty\n"); uniq.reset(); std::cout << (uniq ? "not empty\n" : "empty\n"); }
Output:
not empty [deleter called] empty