[#absl-c_lexicographical_compare-08]
= xref:absl.adoc[absl]::c_lexicographical_compare
:relfileprefix: ../
:mrdocs:

`c_lexicographical_compare` overloads

== Synopses

Declared in `<absl/algorithm/container.h>`

Container‐based version of the <algorithm> `std::lexicographical_compare()` function to lexicographically compare (e.g. sort words alphabetically) two container sequences. The comparison is performed using `operator<`. Note that capital letters ("A‐Z") have ASCII values less than lowercase letters ("a‐z").


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    typename Sequence1,
    typename Sequence2>
constexpr
bool
xref:absl/c_lexicographical_compare-06.adoc[c_lexicographical_compare](
    Sequence1 const& sequence1,
    Sequence2 const& sequence2);
----

[.small]#xref:absl/c_lexicographical_compare-06.adoc[_» more..._]#

Overload of `c_lexicographical_compare()` for performing a lexicographical comparison using a `comp` operator instead of `operator<`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    typename Sequence1,
    typename Sequence2,
    typename LessThan>
constexpr
bool
xref:absl/c_lexicographical_compare-05.adoc[c_lexicographical_compare](
    Sequence1 const& sequence1,
    Sequence2 const& sequence2,
    LessThan&& comp);
----

[.small]#xref:absl/c_lexicographical_compare-05.adoc[_» more..._]#

== Return Value

* `true` if `sequence1` is lexicographically less than `sequence2`, otherwise `false`.
* `true` if `sequence1` is lexicographically less than `sequence2` under `comp`, otherwise `false`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *sequence1*
| The first container.
| *sequence2*
| The second container.
| *comp*
| The comparison used to order the elements.
|===


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