Unicode.utf16ToUcs4

Convert a string from UTF-16 to UCS-4. The result will be nul-terminated.

struct Unicode
static
dchar*
utf16ToUcs4

Parameters

str wchar*

a UTF-16 encoded string

len glong

the maximum length (number of #gunichar2) of @str to use. If @len < 0, then the string is nul-terminated.

itemsRead glong

location to store number of words 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.

itemsWritten glong

location to store number of characters written, or %NULL. The value stored here does not include the trailing 0 character.

Return Value

Type: dchar*

a pointer to a newly allocated UCS-4 string. This value must be freed with g_free(). If an error occurs, %NULL will be returned and @error set.

Throws

GException on failure.

Meta