[#BloombergLP-bslstl-RandomAccessIterator-operator_minus_eq]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator]::operator‐=
:relfileprefix: ../../../
:mrdocs:

Regress this iterator by the specified offset.

== Synopsis

Declared in `<bslstl_randomaccessiterator.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator<T, ITER_IMP, TAG_TYPE>]&
operator‐=(xref:BloombergLP/bslstl/RandomAccessIterator/difference_type.adoc[difference_type] offset);
----

== Description

Decrement by the specified `offset` number of elements. Return a reference to this modifiable iterator. The behavior is undefined unless the iterator, after decrementing by `offset`, is within the bounds of the underlying sequence.

== Return Value

reference to this modifiable iterator

== Parameters

[cols="1,4"]
|===
| Name| Description
| *offset*
| number of elements to regress
|===


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