mdz_utf8_create_attached - maxdz-gmbh/mdz_unicode GitHub Wiki

Create empty UTF-8 string with Capacity == 1 (for 0-terminator), Size == 0 and Length == 0.
Memory for utf8 structure starts at position pStart. Size of internal utf8 structure (it is usually bigger than mdz_Utf8!) is returned in pSize.

struct mdz_Utf8* mdz_utf8_create_attached(const void* pStart, size_t nAreaSizeBytes, size_t* pOutSize);

Parameter	Description
pStart	memory start position of utf8 structure
nAreaSizeBytes	size of available memory from pStart in bytes. Should be large enough for internal utf8 structure
pOutSize	returned actual size of placed internal utf8 structure in bytes, may be NULL if not needed

Return	Description
NULL	if library is not initialized with mdz_unicode_init() call
NULL	if pStart == NULL or pSize == NULL
NULL	if size in nSize is smaller than size of internal utf8 structure
Result	pointer to string for use in other mdz_utf8 functions. Normally it equals to pStart