[#BloombergLP-bdlb-String-upperCaseCmp-036]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::xref:BloombergLP/bdlb/String.adoc[String]::upperCaseCmp
:relfileprefix: ../../../
:mrdocs:

`upperCaseCmp` overloads

== Synopses

Declared in `<bdlb_string.h>`

Compare `lhsString` and `rhsString` using case‐insensitive ordering.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-0bd.adoc[upperCaseCmp](
    xref:bsl/string.adoc[bsl::string] const& lhsString,
    xref:bsl/string.adoc[bsl::string] const& rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-0bd.adoc[_» more..._]#

Compare a `bsl::string` and C string using case‐insensitive ordering.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-037.adoc[upperCaseCmp](
    xref:bsl/string.adoc[bsl::string] const& lhsString,
    char const* rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-037.adoc[_» more..._]#

Compare `lhsString` and `rhsString` using case‐insensitive ordering.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-0b9.adoc[upperCaseCmp](
    char const* lhsString,
    xref:bsl/string.adoc[bsl::string] const& rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-0b9.adoc[_» more..._]#

Compare the specified `lhsString` and `rhsString` having the optionally specified `lhsLength` and `rhsLength`, respectively, _as_ _if_ the strings were converted to upper case before the comparison. Return 1 if `lhsString` is lexically greater than `rhsString`, 0 if they are equal, 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`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-09.adoc[upperCaseCmp](
    char const* lhsString,
    char const* rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-09.adoc[_» more..._]#

Compare `lhsString` and `rhsString` using case‐insensitive ordering.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-06.adoc[upperCaseCmp](
    xref:bsl/string.adoc[bsl::string] const& lhsString,
    char const* rhsString,
    int rhsLength);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-06.adoc[_» more..._]#

Compare `lhsString` and `rhsString` using case‐insensitive ordering.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-05.adoc[upperCaseCmp](
    char const* lhsString,
    int lhsLength,
    xref:bsl/string.adoc[bsl::string] const& rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-05.adoc[_» more..._]#

Compare the specified `lhsString` and `rhsString` having the optionally specified `lhsLength` and `rhsLength`, respectively, _as_ _if_ the strings were converted to upper case before the comparison.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-07.adoc[upperCaseCmp](
    char const* lhsString,
    int lhsLength,
    char const* rhsString);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-07.adoc[_» more..._]#

Compare the specified `lhsString` and `rhsString` having the optionally specified `lhsLength` and `rhsLength`, respectively, _as_ _if_ the strings were converted to upper case before the comparison.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-08.adoc[upperCaseCmp](
    char const* lhsString,
    char const* rhsString,
    int rhsLength);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-08.adoc[_» more..._]#

Same as the preceding overload, with an explicit `rhsLength`.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
int
xref:BloombergLP/bdlb/String/upperCaseCmp-00.adoc[upperCaseCmp](
    char const* lhsString,
    int lhsLength,
    char const* rhsString,
    int rhsLength);
----

[.small]#xref:BloombergLP/bdlb/String/upperCaseCmp-00.adoc[_» more..._]#


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