mdz_utf8_attachData - maxdz-gmbh/mdz_unicode GitHub Wiki

Attach pre-allocated data to UTF-8 string, assigning pData to m_pData. If attached, m_pData will not be destroyed in mdz_utf8_destroy()

mdz_bool mdz_utf8_attachData(
  struct mdz_Utf8* pUtf8,
  unsigned char* pData,
  size_t nOffsetFromStart,
  size_t nCapacity,
  enum mdz_attach_type enAttachType);

Parameter	Description
pUtf8	pointer to string returned by mdz_utf8_create() or mdz_utf8_create_attached()
pData	pointer to pre-allocated data to attach
nOffsetFromStart	position in pre-allocated data to attach from. Can be > 0
nCapacity	full capacity pre-allocated data in items
enAttachType	type of attachment. 0 is expected at position pData[nOffsetFromStart] if MDZ_ATTACH_ZEROSIZE. 0 is expected at position pData[nCapacity] if MDZ_ATTACH_SIZE_TERMINATOR. MDZ_ATTACH_SIZE_NO_TERMINATOR is not allowed

Return	Description
mdz_false	if pUtf8 == NULL
mdz_false	if pData == NULL (MDZ_ERROR_DATA), or nOffsetFromStart >= nCapacity (MDZ_ERROR_OFFSET), or invalid enAttachType (MDZ_ERROR_ATTACHTYPE)
mdz_false	if enAttachType is MDZ_ATTACH_ZEROSIZE or MDZ_ATTACH_SIZE_TERMINATOR but 0 is not found at expected position (MDZ_ERROR_ATTACH_TERMINATOR)
mdz_false	if enAttachType == MDZ_ATTACH_SIZE_TERMINATOR and pData contains invalid UTF-8 characters (MDZ_ERROR_CONTENT)
mdz_true	operation succeeded