[#BloombergLP-bslma-DestructionUtil]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslma.adoc[bslma]::DestructionUtil
:relfileprefix: ../../
:mrdocs:

This `struct` provides a namespace for a suite of utility functions that destroy elements of the parameterized type `TYPE`. Depending on the traits of `TYPE`, the destructor may be invoked or not (i.e., optimized away as a no‐op).

== Synopsis

Declared in `<bslma_destructionutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct DestructionUtil;
----

== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslma/DestructionUtil/destroy.adoc[`destroy`] 
| Destroy the specified `object` of the parameterized `TYPE`, as if by calling the `TYPE` destructor, but do not deallocate the memory occupied by `object`. Note that the destructor may deallocate other memory owned by `object`. Also note that this function is a no‐op if the `TYPE` has the trivial destructor trait.
|===



[.small]#Created with https://www.mrdocs.com[MrDocs]#