# std::declare_reachable

> C++ Atlas: `cppatlas.com/w/cpp/memory/gc/declare_reachable` | Source: https://en.cppreference.com/w/cpp/memory/gc/declare_reachable | Domain: Memory management | Standards: C++11, C++23

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.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <memory>
void declare_reachable( void* p ); // (since C++11) (removed in C++23)
```

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.

### Parameters

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

### Return value

(none)

### Exceptions

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

### See also

- [`undeclare_reachable`](https://en.cppreference.com/w/cpp/memory/gc/undeclare_reachable) (C++11): declares that an object can be recycled (function template)

---
Attribution: content from https://en.cppreference.com/w/cpp/memory/gc/declare_reachable (cppreference.com), licensed under CC-BY-SA 3.0 and GFDL. Modified: converted to markdown, study notes added. Offline snapshot of 9 February 2025.