mdz_ansi_attachData

Attach pre-allocated data to string, assigning pcData to m_pData. If attached, m_pData will not be destroyed in mdz_ansi_destroy()

mdz_bool mdz_ansi_attachData(
  struct mdz_Ansi* pAnsi,
  const char* pData,
  size_t nOffsetFromStart,
  size_t nCapacity,
  enum mdz_attach_type enAttachType);

Parameter	Description
pAnsi	pointer to string returned by mdz_ansi_create() or mdz_ansi_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 of 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 - 1] if MDZ_ATTACH_SIZE_TERMINATOR

Return	Description
mdz_false	if pAnsi == NULL
mdz_false	if pData == NULL (MDZ_ERROR_DATA), or nOffsetFromStart >= nCapacity (MDZ_ERROR_OFFSET)
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_true	operation succeeded

mdz_ansi API Reference is generated using mdzApiRefGenerator.