utf8ToUcs4

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4. A trailing 0 character will be added to the string after the converted text.

dchar[]
utf8ToUcs4
(
string str
,
glong len
,
out glong itemsRead
)

Parameters

str string

a UTF-8 encoded string

len glong

the maximum length of str to use, in bytes. If len < 0, then the string is nul-terminated.

itemsRead glong

location to store number of bytes read, or null. If null, then G_CONVERT_ERROR_PARTIAL_INPUT will be returned in case str contains a trailing partial character. If an error occurs then the index of the invalid input is stored here.

Return Value

Type: dchar[]

a pointer to a newly allocated UCS-4 string. This value must be freed with glib.global.gfree. If an error occurs, null will be returned and error set.