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.