[#BloombergLP-bslstl-operator_le]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::operator&lt;&equals;
:relfileprefix: ../../
:mrdocs:

Return `true` if `lhs` precedes or equals `rhs` in the iteration sequence&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class T1,
    class T2,
    class ITER&lowbar;IMP,
    class TAG&lowbar;TYPE&gt;
bool
operator&lt;&equals;(
    xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator&lt;T1, ITER&lowbar;IMP, TAG&lowbar;TYPE&gt;] const& lhs,
    xref:BloombergLP/bslstl/RandomAccessIterator.adoc[RandomAccessIterator&lt;T2, ITER&lowbar;IMP, TAG&lowbar;TYPE&gt;] const& rhs);
----

== Description

Return `true` if (1) the specified `lhs` iterator has the same value as the specified `rhs` iterator, or (2) `lhs` refers to an element before `rhs` in the iteration sequence, or (3) `rhs` has the past&hyphen;the&hyphen;end value for an iterator over this sequence, and `false` otherwise&period; The behavior is undefined unless `lhs` and `rhs` are iterators into the same underlying sequence&period;

== Return Value

`true` if `lhs` precedes or equals `rhs` in the iteration sequence, and `false` otherwise

== Parameters

[cols="1,4"]
|===
| Name| Description
| *lhs*
| first iterator to compare
| *rhs*
| second iterator to compare
|===


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