text_property_to_text_list


Description:

[ Version ( since = "2.24" ) ]
public int text_property_to_text_list (Atom encoding, int format, uint8 text, int length, string list)

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:

this

The Display where the encoding is defined

encoding

an atom representing the encoding. The most common values for this are STRING, or COMPOUND_TEXT. This is value used as the type for the property

format

the format of the property

text

The text data

length

The number of items to transform

list

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

Returns:

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