Method

GdkX11.X11Display.text_property_to_text_list

Declaration [src]

int
gdk_x11_display_text_property_to_text_list (
  GdkDisplay* display,
  const char* encoding,
  int format,
  const guchar* text,
  int length,
  char*** list
)

Description [src]

Convert a text string from the encoding as it is stored in a property into an array of strings in the encoding of the current locale. (The elements of the array represent the nul-separated elements of the original text string.)

Parameters

encoding const char*
 

a string representing the encoding. The most common values for this are “STRING”, or “COMPOUND_TEXT”. This is value used as the type for the property

 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string
format int
 

the format of the property

text const guchar*
 

The text data

 Ownership is not transferred to the callee
length int
 

The number of items to transform

list char***
 

location to store an array of strings in the encoding of the current locale. This array should be freed using gdk_x11_free_text_list().

 Ownership is not transferred to the callee
 The string is a NUL terminated UTF-8 string

Return value

Returns: int

the number of strings stored in list, or 0, if the conversion failed