[#BloombergLP-bdld-Datum-copyString-04]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bdld.adoc[bdld]::xref:BloombergLP/bdld/Datum.adoc[Datum]::copyString
:relfileprefix: ../../../
:mrdocs:

`copyString` overloads

== Synopses

Declared in `<bdld_datum.h>`

Return, by value, a datum having the copy of the specified `StringRef` `value`, using the specified `allocator` to supply memory (if needed). The behavior is undefined unless `value.length() <= UINT_MAX`. Note that the copied string is owned, and will be freed if `Datum::destroy` is called on the returned object.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdld/Datum.adoc[Datum]
xref:BloombergLP/bdld/Datum/copyString-00.adoc[copyString](
    xref:BloombergLP/bslstl/StringRef.adoc[bslstl::StringRef] const& value,
    xref:BloombergLP/bdld/Datum/AllocatorType.adoc[AllocatorType] const& allocator);
----

[.small]#xref:BloombergLP/bdld/Datum/copyString-00.adoc[_» more..._]#

Return, by value, a datum that refers to the copy of the specified `string` having the specified `length`, using the specified `allocator` to supply memory (if needed). The behavior is undefined unless `0 != string || 0 == length`. The behavior is also undefined unless `length <= UINT_MAX`. Note that the copied string is owned and will be freed if `Datum::destroy` is called on the returned object.


[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bdld/Datum.adoc[Datum]
xref:BloombergLP/bdld/Datum/copyString-0c.adoc[copyString](
    char const* string,
    xref:BloombergLP/bdld/Datum/SizeType.adoc[SizeType] length,
    xref:BloombergLP/bdld/Datum/AllocatorType.adoc[AllocatorType] const& allocator);
----

[.small]#xref:BloombergLP/bdld/Datum/copyString-0c.adoc[_» more..._]#


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