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

`destroy` overloads

== Synopses

Declared in `<bslalg_arraydestructionprimitives.h>`

Destroy the elements in the specified array range.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TARGET_TYPE>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-04.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-04.adoc[_» more..._]#

Destroy each `TARGET_TYPE` in `[begin, end)]` using the destructor.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TARGET_TYPE>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0e.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    xref:bsl/false_type.adoc[bsl::false_type] traits);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0e.adoc[_» more..._]#

Destroy each `TARGET_TYPE` in `[begin, end)]`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class TARGET_TYPE>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-02.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    xref:bsl/true_type.adoc[bsl::true_type] traits);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-02.adoc[_» more..._]#

Destroy the elements in the specified array range using an allocator.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0a.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    ALLOCATOR allocator);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0a.adoc[_» more..._]#

Same as the preceding `destroy` overload, for non‐bitwise‐copyable types.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-09.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    ALLOCATOR allocator,
    xref:bsl/false_type.adoc[bsl::false_type] traits);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-09.adoc[_» more..._]#

Destroy each `TARGET_TYPE` in `[begin, end)]` using an allocator.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class TARGET_TYPE,
    class ALLOCATOR>
static
void
xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0b.adoc[destroy](
    TARGET_TYPE* begin,
    TARGET_TYPE* end,
    ALLOCATOR allocator,
    xref:bsl/true_type.adoc[bsl::true_type] traits);
----

[.small]#xref:BloombergLP/bslalg/ArrayDestructionPrimitives/destroy-0b.adoc[_» more..._]#

== Parameters

[cols="1,4"]
|===
| Name| Description
| *begin*
| beginning of the range of elements to destroy
| *end*
| end of the range of elements to destroy (one past the last)
| *traits*
| unused trait tag for overload resolution
| *allocator*
| allocator used to destroy elements
|===


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