to_utf16


Description:

[ CCode ( cname = "g_ucs4_to_utf16" ) ]
public string16 to_utf16 (long len = -1, out long items_read = null, out long items_written = null) throws ConvertError

Convert a string from UCS-4 to UTF-16.

A 0 character will be added to the result after the converted text.

Parameters:

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 bytes read, or null. If an error occurs then the index of the invalid input is stored here.

items_written

location to store number of unichar2 written, or null . The value stored here does not include the trailing 0.

str

a UCS-4 encoded string

Returns:

a pointer to a newly allocated UTF-16 string. This value must be freed with g_free . If an error occurs, null will be returned and throws set.