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

Load the specified `result` with a reference to a newly created character buffer of the specified `length`, using the specified `allocator` to supply memory, and return the address of this buffer. The behavior is undefined unless `length <= UINT_MAX`. Note that the caller is responsible for initializing the returned buffer with a UTF‐8 encoded string.

== Synopsis

Declared in `<bdld_datum.h>`

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


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