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

Create an uninitialized string buffer and load a datum referring to it.

== 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);
----

== Description

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.

== Return Value

the address of the uninitialized character buffer

== Parameters

[cols="1,4"]
|===
| Name| Description
| *result*
| receives the datum that refers to the buffer
| *length*
| length of the character buffer in bytes
| *allocator*
| memory allocator to use
|===


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