to_utf32

Description:

[ CCode ( cname = "g_utf8_to_ucs4" ) ]
public string32 to_utf32 (long len = -1, out long items_read = null, out long items_written = null) throws ConvertError

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.

Parameters:

len	the maximum length of `str` to use, in bytes. If `len` < 0, then the string is nul-terminated.
items_read	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.
items_written	location to store number of characters written or null. The value here stored does not include the trailing 0 character.
str	a UTF-8 encoded string

Returns:

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 throws set.