# std::undeclare_reachable

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

Removes the reachable status of the object, referenced by the pointer p, if it was previously set by std::declare_reachable.

## Official Specification Summary (cppreference)

```cpp
// 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` 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.

### 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

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

---
Attribution: content from https://en.cppreference.com/w/cpp/memory/gc/undeclare_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.