std::declare_reachable - cppreference.com

##### cppreference.com

##### Search

Create account

##### Namespaces

- Page
- Discussion

##### Variants

##### Views

- View
- Edit
- History

##### Actions

# std::declare_reachable

From cppreference.com
< cpp‎ | memory

Defined in header `<memory>` |  |
void declare_reachable( void* p ); |  | (since C++11)

Declares the object referenced by the pointer `p` reachable. Reachable objects will not be deleted by the garbage collector or considered to be a leak by a leak detector even if all pointers to it are destroyed. An object may be declared reachable multiple times, in which case multiple calls to std::undeclare_reachable would be needed to remove this property. For example, a XOR linked list needs to declare its nodes reachable if the implementation has garbage collection enabled.

### [edit] Parameters

p | - | a safely-derived pointer or a null pointer

### [edit] Return value

(none)

### [edit] Exceptions

May throw std::bad_alloc if the system cannot allocate memory required to track reachable objects.

### [edit] Example

| This section is incomplete Reason: no example

### [edit] See also

undeclare_reachable (C++11) | declares that an object can be recycled (function template) [edit]

Retrieved from "http://en.cppreference.com/mwiki/index.php?title=cpp/memory/gc/declare_reachable&oldid=80258"
Category:

- Todo no example