mdz_utf8_insertUtf32_async - maxdz-gmbh/mdz_unicode GitHub Wiki
Insert nCount UTF-32 characters in string. UTF-32 characters are converted to UTF-8 before isertion. Size grows on added bytes. Length grows on symbols count.
String reserved area and pItems should not overlap.
Unicode "combining characters" are not specially-distinguished and counted as a separate UTF-8 symbol.
mdz_bool mdz_utf8_insertUtf32_async(
struct mdz_Utf8* pUtf8,
size_t nLeftPos,
const uint32_t* pItems,
size_t nCount,
enum mdz_endianness enEndianness,
mdz_bool bReserve,
struct mdz_asyncData* pAsyncData);
Synchronous version:
mdz_utf8_insertUtf32(pUtf8, nLeftPos, pItems, nCount, enEndianness, bReserve);
| Parameter | Description |
|---|---|
pUtf8 |
pointer to string returned by mdz_utf8_create() or mdz_utf8_create_attached()
|
nLeftPos |
0-based position to insert in symbols. If nLeftPos == Length or -1, items are appended. nLeftPos > Length is not allowed |
pItems |
UTF-32 characters to insert |
nCount |
number of UTF-32 characters to insert or 0 if pcItems until 0-terminator should be used |
enEndianness |
endianness of UTF-32 characters in pItems. Can be MDZ_ENDIAN_LITTLE for "little-endian" or MDZ_ENDIAN_BIG for "big-endian" |
bReserve |
if mdz_true reserve capacity when there is not enough space for insertion, otherwise mdz_false |
pAsyncData |
pointer to shared async data for asynchronous call, or NULL if call should be synchronous |
| Return | Description |
|---|---|
| mdz_false | if pUtf8 == NULL
|
| mdz_false | if bReserve == mdz_true and memory allocation failed (MDZ_ERROR_ALLOCATION) |
| mdz_false | if bReserve == mdz_true and there is not enough capacity for inserted data, but m_pData is attached using mdz_utf8_attachData() (MDZ_ERROR_ATTACHED) |
| mdz_false | if bReserve == mdz_false and there is not enough free Capacity in the string (MDZ_ERROR_CAPACITY) |
| mdz_false | if string reserved area and pItems overlap (MDZ_ERROR_OVERLAP) |
| mdz_true | if pItems == NULL (MDZ_ERROR_ITEMS), or nCount == 0 (MDZ_ERROR_ZEROCOUNT), or nLeftPos > Length (MDZ_ERROR_BIGLEFT). No insertion is made |
| mdz_true | insertion succeeded |