GLib.ucs4_to_utf8
function ucs4_to_utf8(str: String, len: Number(glong), items_read: Number(glong), items_written: Number(glong)): String { // Gjs wrapper for g_ucs4_to_utf8() }
Convert a string from a 32-bit fixed width representation as UCS-4. to UTF-8. The result will be terminated with a 0 byte.
- str
a UCS-4 encoded string
- len
the maximum length (number of characters) of str to use. If len < 0, then the string is nul-terminated.
- items_read
location to store number of characters read, or null.
- items_written
location to store number of bytes written or null. The value here stored does not include the trailing 0 byte.
- Returns
a pointer to a newly allocated UTF-8 string. This value must be freed with GLib.free. If an error occurs, null will be returned and @error set. In that case, items_read will be set to the position of the first invalid input character.