Function

GLibutf8_to_ucs4_fast

Declaration

gunichar*
g_utf8_to_ucs4_fast (
  const gchar* str,
  glong len,
  glong* items_written
)

Description

Convert a string from UTF-8 to a 32-bit fixed width representation as UCS-4, assuming valid UTF-8 input. This function is roughly twice as fast as g_utf8_to_ucs4() but does no error checking on the input. A trailing 0 character will be added to the string after the converted text.

Parameters

`str`	`const gchar*`
	A UTF-8 encoded string.
	The data is owned by the caller of the function.
	The value is a NUL terminated UTF-8 string.
`len`	`glong`
	The maximum length of `str` to use, in bytes. If `len` < 0, then the string is nul-terminated.
`items_written`	`glong*`
	Location to store the number of characters in the result, or `NULL`.
	The argument will be set by the function.
	The argument can be `NULL`.

Return value

Returns:	`gunichar*`
	A pointer to a newly allocated UCS-4 string. This value must be freed with g_free().
	The caller of the function takes ownership of the data, and is responsible for freeing it.