[#BloombergLP-bdlb-StringRefUtil]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdlb.adoc[bdlb]::StringRefUtil
:relfileprefix: ../../
:mrdocs:

This `struct` provides a namespace for a suite of functions on `bslstl::StringRef` references to strings.

== Synopsis

Declared in `<bdlb_stringrefutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
struct StringRefUtil;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/StringRefUtil/size_type.adoc[`size_type`] 
| Size type of string references.
|===


== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/StringRefUtil/areEqualCaseless.adoc[`areEqualCaseless`] 
| Return `true` if `lhs` and `rhs` compare equal ignoring case.
| xref:BloombergLP/bdlb/StringRefUtil/findFirstNotOf.adoc[`findFirstNotOf`] 
| Return the position of the first non‐matching character in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/findFirstOf.adoc[`findFirstOf`] 
| Return the position of the first matching character in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/findLastNotOf.adoc[`findLastNotOf`] 
| Return the position of the last non‐matching character in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/findLastOf.adoc[`findLastOf`] 
| Return the position of the last matching character in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/lowerCaseCmp.adoc[`lowerCaseCmp`] 
| Compare `lhs` and `rhs` after converting both to lower case.
| xref:BloombergLP/bdlb/StringRefUtil/ltrim.adoc[`ltrim`] 
| Return a string reference with leading whitespace removed.
| xref:BloombergLP/bdlb/StringRefUtil/rtrim.adoc[`rtrim`] 
| Return a string reference with trailing whitespace removed.
| xref:BloombergLP/bdlb/StringRefUtil/strrstr.adoc[`strrstr`] 
| Return a reference to the last occurrence of `subString` in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/strrstrCaseless.adoc[`strrstrCaseless`] 
| Return a reference to the last case‐insensitive occurrence of `subString` in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/strstr.adoc[`strstr`] 
| Return a reference to the first occurrence of `subString` in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/strstrCaseless.adoc[`strstrCaseless`] 
| Return a reference to the first case‐insensitive occurrence of `subString` in `string`.
| xref:BloombergLP/bdlb/StringRefUtil/substr.adoc[`substr`] 
| Return a substring of `string` starting at `position`.
| xref:BloombergLP/bdlb/StringRefUtil/trim.adoc[`trim`] 
| Return a string reference with leading and trailing whitespace removed.
| xref:BloombergLP/bdlb/StringRefUtil/upperCaseCmp.adoc[`upperCaseCmp`] 
| Compare `lhs` and `rhs` after converting both to upper case.
|===


== Static Data Members

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/StringRefUtil/k_NPOS.adoc[`k_NPOS`] 
| Value used to denote "not‐a‐position", guaranteed to be outside the `range[0 .. INT_MAX]`.
|===



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