Function
GLibucs4_to_utf8
Declaration
gchar*
g_ucs4_to_utf8 (
const gunichar* str,
glong len,
glong* items_read,
glong* items_written,
GError** error
)
Description
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.
Parameters
str |
const gunichar* |
A UCS-4 encoded string. |
|
The data is owned by the caller of the function. | |
len |
glong |
The maximum length (number of characters) of |
|
items_read |
glong* |
Location to store number of
characters read, or |
|
The argument will be set by the function. | |
The argument can be NULL . | |
items_written |
glong* |
Location to store number
of bytes written or |
|
The argument will be set by the function. | |
The argument can be NULL . | |
error |
GError ** |
The return location for a GError* , or NULL . |
Return value
Returns: | gchar* |
A pointer to a newly allocated UTF-8 string.
This value must be freed with g_free(). If an error occurs,
|
|
The caller of the function takes ownership of the data, and is responsible for freeing it. | |
The value is a NUL terminated UTF-8 string. |