Function

Gdktext_property_to_utf8_list_for_display

since: 2.2

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

Type: GdkDisplay

A GdkDisplay.

The data is owned by the caller of the function.

encoding

Type: GdkAtom

An atom representing the encoding of the text.

format

Type: gint

The format of the property.

text

Type: 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

Type: gint

The length of text, in bytes.

list

Type: 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 array must be NULL-terminated.

The caller of the function takes ownership of the returned data, and is responsible for freeing it.

Each element is a NUL terminated UTF-8 string.

Return value

Type: gint

The number of strings in the resulting list.