GLib.utf8_to_utf16
function utf8_to_utf16(str: String, len: Number(glong), items_read: Number(glong), items_written: Number(glong)): Number(guint16) { // Gjs wrapper for g_utf8_to_utf16() }
Convert a string from UTF-8 to UTF-16. A 0 character will be added to the result after the converted text.
- str
a UTF-8 encoded string
- len
the maximum length (number of bytes) of str to use. 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 #gunichar2 written, or null. The value stored here does not include the trailing 0.
- Returns
a pointer to a newly allocated UTF-16 string. This value must be freed with GLib.free. If an error occurs, null will be returned and @error set.