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

Move the begin iterator by the specified `offset`.

== Synopsis

Declared in `<bslalg_dequeprimitives.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslalg/DequePrimitives_DequeElementGuard/Iterator.adoc[DequePrimitives_DequeElementGuard<VALUE_TYPE, BLOCK_LENGTH, ALLOCATOR>::Iterator]&
moveBegin(std::ptrdiff_t offset = ‐1);
----

== Description

Move the begin iterator by the specified `offset`, and return the new begin iterator.

== Return Value

the new begin iterator after applying `offset`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *offset*
| signed displacement applied to the begin iterator
|===


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