[#BloombergLP-bslalg-RangeCompare-lexicographical-02]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/RangeCompare.adoc[RangeCompare]::lexicographical
:relfileprefix: ../../../
:mrdocs:

`lexicographical` overloads

== Synopses

Declared in `<bslalg_rangecompare.h>`

Compare two ranges in lexicographical order.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITER>
static
int
xref:BloombergLP/bslalg/RangeCompare/lexicographical-07.adoc[lexicographical](
    INPUT_ITER start1,
    INPUT_ITER end1,
    INPUT_ITER start2,
    INPUT_ITER end2);
----

[.small]#xref:BloombergLP/bslalg/RangeCompare/lexicographical-07.adoc[_» more..._]#

Same as the preceding `lexicographical` overload, taking explicit range lengths.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<class INPUT_ITER>
static
int
xref:BloombergLP/bslalg/RangeCompare/lexicographical-04.adoc[lexicographical](
    INPUT_ITER start1,
    INPUT_ITER end1,
    xref:BloombergLP/bslalg/RangeCompare/size_type.adoc[size_type] length1,
    INPUT_ITER start2,
    INPUT_ITER end2,
    xref:BloombergLP/bslalg/RangeCompare/size_type.adoc[size_type] length2);
----

[.small]#xref:BloombergLP/bslalg/RangeCompare/lexicographical-04.adoc[_» more..._]#

== Return Value

a negative value if the first range is less, 0 if equal, and a positive value if the first range is greater

== Parameters

[cols="1,4"]
|===
| Name| Description
| *start1*
| beginning of the first range
| *end1*
| end of the first range (one past the last element)
| *start2*
| beginning of the second range
| *end2*
| end of the second range (one past the last element)
| *length1*
| length of the first range
| *length2*
| length of the second range
|===


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