Function

Gdktext_property_to_utf8_list_for_display

Declaration [src]

gint
gdk_text_property_to_utf8_list_for_display (
  GdkDisplay* display,
  GdkAtom encoding,
  gint format,
  const guchar* text,
  gint length,
  gchar*** list
)

Description [src]

Converts a text property in the given encoding to a list of UTF-8 strings.

Available since:2.2

Parameters

display GdkDisplay
 

A GdkDisplay.

 The data is owned by the caller of the function.
encoding GdkAtom
 

An atom representing the encoding of the text.

format gint
 

The format of the property.

text An array of guchar
 

The text to convert.

 The length of the array is specified in the length argument.
 The data is owned by the caller of the function.
length gint
 

The length of text, in bytes.

list An array of gchar**
 

Location to store the list of strings or NULL. The list should be freed with g_strfreev().

 The argument will be set by the function.
 The called function takes ownership of the data, and is responsible for freeing it.

Return value

Returns: gint
 

The number of strings in the resulting list.