to_utf8


Description:

[ CCode ( cname = "g_ucs4_to_utf8" ) ]
public string to_utf8 (long len = -1, out long items_read = null, out long items_written = null) throws ConvertError

Convert a string from a 32-bit fixed width representation as UCS-4.

to UTF-8.

The result will be terminated with a nul byte.

Parameters:

len

the maximum length (number of characters) of str to use. If len is negative, then the string is nul-terminated.

items_read

location to store number of characters read, or `NULL` to ignore. If an error occurs then the index of the invalid input is stored here. The value stored here will never be negative.

items_written

location to store number of bytes written, or `NULL` to ignore. The value stored here does not include the trailing nul, and will never be negative.

str

a UCS-4 encoded string

Returns:

a pointer to a newly allocated UTF-8 string. This value must be freed with [func@GLib.free].