[#BloombergLP-bdlb-String-lowerCaseCmp-09e]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::xref:BloombergLP/bdlb/String.adoc[String]::lowerCaseCmp
:relfileprefix: ../../../
:mrdocs:

Compare two strings using case‐insensitive ordering.

== Synopsis

Declared in `<bdlb_string.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
lowerCaseCmp(
    char const* lhsString,
    char const* rhsString);
----

== Description

Compare the specified `lhsString` and `rhsString` having the optionally specified `lhsLength` and `rhsLength`, respectively. Return 1 if, after conversion to lower case, `lhsString` is lexically greater than `rhsString`, 0 if they are equal up to a case conversion, and ‐1 otherwise. The behavior is undefined unless `0 <= lhsLength` and `0 <= rhsLength` (if specified), and `lhsString.size() <= INT_MAX` and `rhsString.size() <= INT_MAX` (if applicable). See {`bdlb_stringviewutil`} for an identically named method having the same semantics taking `bsl::string_view`.


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