GLib.utf8_to_ucs4

function utf8_to_ucs4(str: String, len: Number(glong), items_read: Number(glong), items_written: Number(glong)): String {
    // Gjs wrapper for g_utf8_to_ucs4()
}

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.

str

a UTF-8 encoded string

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 GLib.ConvertError.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.

Returns

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