[#BloombergLP-bslstl-RandomAccessIterator-operator_minus_eq]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator]::operator&hyphen;&equals;
:relfileprefix: ../../../
:mrdocs:

Regress this iterator by the specified offset&period;

== Synopsis

Declared in `&lt;bslstl&lowbar;randomaccessiterator&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator&lt;T, ITER&lowbar;IMP, TAG&lowbar;TYPE&gt;]&
operator&hyphen;&equals;(xref:BloombergLP/bslstl/RandomAccessIterator/difference_type.adoc[difference&lowbar;type] offset);
----

== Description

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

== 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]#
