[#bsl-operator_3way-0f6]
= xref:bsl.adoc[bsl]::operator<=>
:relfileprefix: ../
:mrdocs:

Perform a lexicographic three‐way comparison of `lhs` and `rhs`.

== Synopsis

Declared in `<bslstl_list.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class VALUE,
    class ALLOCATOR>
xref:BloombergLP/bslalg/SynthThreeWayUtil/Result.adoc[BloombergLP::bslalg::SynthThreeWayUtil::Result<VALUE>]
operator<=>(
    xref:bsl/list-054.adoc[list<VALUE, ALLOCATOR>] const& lhs,
    xref:bsl/list-054.adoc[list<VALUE, ALLOCATOR>] const& rhs);
----

== Description

Compare using the comparison operators of `VALUE` on each element; return the result of that comparison.

== Return Value

result of the three‐way comparison

== Parameters

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


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