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

Subtraction operators

== Synopses

Declared in `<bslstl_randomaccessiterator.h>`

Return an iterator to the element at the specified `rhs` positions before the specified `lhs`. The behavior is undefined unless `lhs`, after decrementing by `rhs`, is within the bounds of the underlying sequence. Note that this function is logically equivalent to: ` iter + (‐rhs) `


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class T,
    class ITER_IMP,
    class TAG_TYPE>
xref:BloombergLP/bslstl/RandomAccessIterator.adoc[bslstl::RandomAccessIterator<T, ITER_IMP, TAG_TYPE>]
xref:BloombergLP/bslstl/operator_minus-02.adoc[operator‐](
    xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator<T, ITER_IMP, TAG_TYPE>] const& lhs,
    std::ptrdiff_t rhs);
----

[.small]#xref:BloombergLP/bslstl/operator_minus-02.adoc[_» more..._]#

Return the distance from the specified `rhs` iterator to the specified `lhs` iterator. The behavior is undefined unless `lhs` and `rhs` are iterators into the same underlying sequence. Note that the result might be negative.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class T1,
    class T2,
    class ITER_IMP,
    class TAG_TYPE>
std::ptrdiff_t
xref:BloombergLP/bslstl/operator_minus-0b.adoc[operator‐](
    xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator<T1, ITER_IMP, TAG_TYPE>] const& lhs,
    xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator<T2, ITER_IMP, TAG_TYPE>] const& rhs);
----

[.small]#xref:BloombergLP/bslstl/operator_minus-0b.adoc[_» more..._]#


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