Skip to content

cf_decode_UTF8

Category: string
GitHub: cute_string.h

Decodes a single UTF8 character from the string as a UTF32 codepoint.

const char* cf_decode_UTF8(const char* s, int* codepoint);
Parameters Description
s The string. Can be NULL.
codepoint An int codepoint in UTF32 form.

Return Value

The return value is not a new string, but just s + bytes, where bytes is anywhere from 1 to 4.

Code Example

Decoding a UTF8 string one codepoint at a time.

int cp;
const char tmp = my_string;
while (tmp) {
    tmp = cf_decode_UTF8(tmp, &cp);
    DoSomethingWithCodepoint(cp);
}

Remarks

You can use this function in a loop to decode one codepoint at a time, where each codepoint represents a single UTF8 character. If the decoded codepoint is invalid then the "replacement character" 0xFFFD will be recorded instead.

sappend_UTF8
cf_decode_UTF16