std::undeclare_reachable

From cppreference.com
< cpp‎ | memory
Memory management library
(exposition only*)
Uninitialized memory algorithms
(C++17)
(C++17)
(C++17)
(C++20)
Constrained uninitialized
memory algorithms
(C++20)
C Library

Allocators
(C++11)
(C++11)
Memory resources
Garbage collection support
(C++11)(until C++23)
undeclare_reachable
(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)
Uninitialized storage
(until C++20*)
(until C++20*)
(until C++20*)
Explicit lifetime management
Defined in header <memory>
template < class T >
T* undeclare_reachable( T* p ) ;
(since C++11)
(removed in C++23)

Removes the reachable status of the object, referenced by the pointer p, if it was previously set by std::declare_reachable. If the object was declared reachable multiple times, equal number of calls to undeclare_reachable

Parameters

p - a pointer to an object previously declared reachable and not destructed since then

Return value

A safely-derived copy of p.

Exceptions

Throws nothing.

See also

(C++11)(removed in C++23)
declares that an object can not be recycled
(function)