# std::allocator_traits<Alloc>::destroy

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

Calls the destructor of the object pointed to by p. If possible, does so by calling a.destroy(p). If not possible (e.g.

## Official Specification Summary (cppreference)

```cpp
// Defined in header <memory>

template< class T >
static void destroy( Alloc& a, T* p ); // (since C++11) (constexpr since C++20)
```

Calls the destructor of the object pointed to by `p`. If possible, does so by calling `a.destroy(p)`. If not possible (e.g. `Alloc` does not have the member function `destroy()`), then calls the destructor of `*p` directly, as `p->~T()` (until C++20) `std::destroy_at(p)` (since C++20).

### Parameters

- `a` - allocator to use for destruction
- `p` - pointer to the object being destroyed

### Return value

(none)

### Notes

Because this function provides the automatic fall back to direct call to the destructor, the member function `destroy()` is an optional *Allocator* requirement since C++11.

### Example

> Note: This section is incomplete Reason: no example

### See also

- [`destroy`](https://en.cppreference.com/w/cpp/memory/allocator/destroy) (until C++20): destructs an object in allocated storage (public member function of `std::allocator<T>`)

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