[#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&hyphen;insensitive ordering&period;

== Synopsis

Declared in `&lt;bdlb&lowbar;string&period;h&gt;`

[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&period; 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 &hyphen;1 otherwise&period; The behavior is undefined unless `0 &lt;&equals; lhsLength` and `0 &lt;&equals; rhsLength` (if specified), and `lhsString&period;size() &lt;&equals; INT&lowbar;MAX` and `rhsString&period;size() &lt;&equals; INT&lowbar;MAX` (if applicable)&period; See &lcub;`bdlb&lowbar;stringviewutil`&rcub; for an identically named method having the same semantics taking `bsl&colon;&colon;string&lowbar;view`&period;

== Return Value

1, 0, or &hyphen;1 as `lhsString` is greater, equal, or less

== Parameters

[cols="1,4"]
|===
| Name| Description
| *lhsString*
| left&hyphen;hand null&hyphen;terminated string
| *rhsString*
| right&hyphen;hand null&hyphen;terminated string
|===


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