[#BloombergLP-bslalg-DequePrimitives_DequeElementGuard]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::DequePrimitives_DequeElementGuard
:relfileprefix: ../../
:mrdocs:

Proctor that destroys a guarded range of deque elements on destruction.

== Synopsis

Declared in `<bslalg_dequeprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class VALUE_TYPE,
    int BLOCK_LENGTH,
    class ALLOCATOR>
class DequePrimitives_DequeElementGuard;
----

== Description

This `class` provides a specialized proctor object that, upon destruction and unless the `release` method has been called, destroys the elements in a segment of a deque of parameterized `VALUE_TYPE`. The elements destroyed are delimited by the "guarded" range `[d_begin .. d_end)]`.

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/Iterator.adoc[`Iterator`] 
| Iterator type over elements in the guarded deque segment.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/2constructor.adoc[`DequePrimitives_DequeElementGuard`]         [.small]#[constructor]#
| Create a guard for the specified initialized deque element range.
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/2destructor.adoc[`~DequePrimitives_DequeElementGuard`] [.small]#[destructor]#
| Destroy the guarded elements and this guard.
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/moveBegin.adoc[`moveBegin`] 
| Move the begin iterator by the specified `offset`.
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/moveEnd.adoc[`moveEnd`] 
| Move the end iterator by the specified `offset`.
| xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/release.adoc[`release`] 
| Set the range of elements guarded by this object to be empty. Note that `d_begin == d_end` following this operation, but the specific value is unspecified.
|===



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