[#BloombergLP-bslalg-DequePrimitives-01-destruct-04]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/DequePrimitives-01.adoc[DequePrimitives]::destruct
:relfileprefix: ../../../
:mrdocs:

Destroy each element in the specified deque range.

== Synopsis

Declared in `<bslalg_dequeprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class ALLOCATOR>
static
void
destruct(
    xref:BloombergLP/bslalg/DequePrimitives-01/Iterator.adoc[Iterator] begin,
    xref:BloombergLP/bslalg/DequePrimitives-01/Iterator.adoc[Iterator] end,
    ALLOCATOR allocator);
----

== Description

Call the destructor on each of the elements of a deque of parameterized `VALUE_TYPE` in the specified range `[begin .. end)]`. The behavior is undefined unless `begin <= end`. Note that this does not deallocate any memory (except memory deallocated by the element destructor calls).

== 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)
| *allocator*
| allocator used to destroy elements
|===


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