mdz_ansi_attachData - maxdz-gmbh/mdz_string GitHub Wiki
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 |