Return a datum referring to the specified null‐terminated string.

Synopsis

Declared in <bdld_datum.h>

static
Datum
createStringRef(
    char const* string,
    AllocatorType const& allocator);

Description

Return, by value, a datum that refers to the specified string, using the specified allocator to supply memory (if needed). The behavior is undefined unless string points to a UTF‐8 encoded c‐string. The behavior is also undefined unless 'strlen(string) <= UINT_MAX'. Note that string is not copied, and is not freed if Datum::destroy is called on the returned object.

Return Value

a datum referring to the specified null‐terminated string

Parameters

Name

Description

string

UTF‐8 null‐terminated string to reference

allocator

memory allocator to use

Created with MrDocs