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

Namespace for utility functions on STL&hyphen;style and C&hyphen;style strings&period;

== Synopsis

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

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

== Description

This `struct` provides a namespace for a suite of functions on STL&hyphen;style strings (`bsl&colon;&colon;string`, `std&colon;&colon;string`, `std&colon;&colon;pmr&colon;&colon;string`), C&hyphen;style strings, and strings specified by a `(const char &ast;, int)` or `(char &ast;, int)` pair&period;

== Static Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:BloombergLP/bdlb/String/areEqualCaseless-010.adoc[`areEqualCaseless`] 
| `areEqualCaseless` overloads
| xref:BloombergLP/bdlb/String/copy-01.adoc[`copy`] 
| Return a newly allocated null&hyphen;terminated copy of `string`&period;
| xref:BloombergLP/bdlb/String/lowerCaseCmp-0c.adoc[`lowerCaseCmp`] 
| Compare two strings using case&hyphen;insensitive ordering&period;
| xref:BloombergLP/bdlb/String/ltrim-03.adoc[`ltrim`] 
| `ltrim` overloads
| xref:BloombergLP/bdlb/String/pad-00.adoc[`pad`] 
| Pad `string` on the right with `padChar` up to `length`&period;
| xref:BloombergLP/bdlb/String/rtrim-07.adoc[`rtrim`] 
| `rtrim` overloads
| xref:BloombergLP/bdlb/String/skipLeadingTrailing.adoc[`skipLeadingTrailing`] 
| Advance `&ast;begin` and regress `&ast;end` past surrounding whitespace&period;
| xref:BloombergLP/bdlb/String/strnlen.adoc[`strnlen`] 
| Return the length of `string`, capped at `maximumLength`&period;
| xref:BloombergLP/bdlb/String/strrstr.adoc[`strrstr`] 
| Return the last occurrence of `subString` in `string`, or 0&period;
| xref:BloombergLP/bdlb/String/strrstrCaseless.adoc[`strrstrCaseless`] 
| Return the last case&hyphen;insensitive match of `subString`, or 0&period;
| xref:BloombergLP/bdlb/String/strstr.adoc[`strstr`] 
| Return the first occurrence of `subString` in `string`, or 0&period;
| xref:BloombergLP/bdlb/String/strstrCaseless.adoc[`strstrCaseless`] 
| Return the first case&hyphen;insensitive match of `subString`, or 0&period;
| xref:BloombergLP/bdlb/String/toFixedLength.adoc[`toFixedLength`] 
| Copy `srcString` into `dstString`, padding to `dstLength` if needed&period;
| xref:BloombergLP/bdlb/String/toLower-089.adoc[`toLower`] 
| Convert upper&hyphen;case characters in `string` to lower case&period;
| xref:BloombergLP/bdlb/String/toUpper-0f.adoc[`toUpper`] 
| Convert lower&hyphen;case characters in `string` to upper case&period;
| xref:BloombergLP/bdlb/String/trim-0bf.adoc[`trim`] 
| `trim` overloads
| xref:BloombergLP/bdlb/String/upperCaseCmp-036.adoc[`upperCaseCmp`] 
| Compare two strings as if both were converted to upper case&period;
|===



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