[#bsl-operator_3way-044]
= xref:bsl.adoc[bsl]::operator&lt;&equals;&gt;
:relfileprefix: ../
:mrdocs:

Perform a lexicographic three&hyphen;way comparison of `lhs` and `rhs`&period;

== Synopsis

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

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template&lt;
    class KEY,
    class VALUE,
    class COMPARATOR,
    class ALLOCATOR&gt;
xref:BloombergLP/bslalg/SynthThreeWayUtil/Result.adoc[BloombergLP::bslalg::SynthThreeWayUtil::Result&lt;bsl::pair&lt;KEY const, VALUE&gt;&gt;]
operator&lt;&equals;&gt;(
    xref:bsl/map-0a7.adoc[map&lt;KEY, VALUE, COMPARATOR, ALLOCATOR&gt;] const& lhs,
    xref:bsl/map-0a7.adoc[map&lt;KEY, VALUE, COMPARATOR, ALLOCATOR&gt;] const& rhs);
----

== Description

Perform a lexicographic three&hyphen;way comparison of the specified `lhs` and the specified `rhs` maps by using the comparison operators of &grave;bsl&colon;&colon;pair&lt;const KEY, VALUE&gt;&grave; on each element&semi; return the result of that comparison&period;

== Return Value

result of the three&hyphen;way comparison

== Parameters

[cols="1,4"]
|===
| Name| Description
| *lhs*
| left&hyphen;hand map to compare
| *rhs*
| right&hyphen;hand map to compare
|===


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