std::undeclare_reachable

From cppreference.com
< cpp‎ | memory
 
C++
 
Utilities library
 
Dynamic memory management
Smart pointers
(C++11)
(C++11)
(C++11)
(until C++17)
(C++11)
(C++11)
(C++11)
(C++11)
Allocators
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Uninitialized storage
(C++11)
Garbage collection support
(C++11)
undeclare_reachable
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
Miscellaneous
(C++11)
(C++11)
(C++11)
C Library
Low level memory management
 
Defined in header <memory>
template< class T >
T* undeclare_reachable( T* p );
 (since C++11)

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 would be needed to remove this status. Once the object is not declared reachable and has no pointers referencing it, it may be reclaimed by garbage collector or reported as a leak by a leak detector.

Contents

[edit] Parameters

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

[edit] Return value

A safely-derived copy of p.

[edit] Exceptions

None

[edit] Example

This section is incomplete
Reason: no example

[edit] See also

(C++11)
 declares that an object can not be recycled
(function)
Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/memory/gc/undeclare_reachable&oldid=80259"