[#BloombergLP-bslalg-ArrayDestructionPrimitives-destroy-0a]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/ArrayDestructionPrimitives.adoc[ArrayDestructionPrimitives]::destroy
:relfileprefix: ../../../
:mrdocs:

Destroy the elements in the segment of an array of parameterized `TARGET_TYPE` beginning at the specified `begin` address and ending immediately before the specified `end` address, using the specified `allocator`. If `begin == 0` and `end == 0` this function has no effect. The behavior is undefined unless either (1) `begin <= end`, `begin != 0`, and `end != 0`, or (2) `begin == 0 && end == 0`. Note that this method does not deallocate any memory (except memory deallocated by the element destructor calls).

== Synopsis

Declared in `<bslalg_arraydestructionprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
destroy(
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    ALLOCATOR allocator);
----


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