XStringListToTextProperty()XStringListToTextProperty()NameXStringListToTextProperty – set the specified list of strings to an
XTextProperty structure.
Synopsis
Status XStringListToTextProperty(list, count, text_prop_return)
char **list;
int count;
XTextProperty *text_prop_return;
Arguments
list Specifies a list of NULL-terminated character strings.
count Specifies the number of strings.
text_prop_return
Returns the XTextProperty structure.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
DescriptionXStringListToTextProperty() fills the specified XTextProperty structure
so that it represents a property of type STRING (format 8) with a value
representing the concatenation of the specified list of null-separated
character strings. An extra byte containing NULL (which is not
included in the nitems member) is stored at the end of the value field
of text_prop. The strings are assumed (without verification) to be in
the STRING encoding. If memory is not available for the new value
string, XStringListToTextProperty() does not set any fields in the
XTextProperty structure and returns a zero status. Otherwise, it
returns a non-zero status. XFree() frees the storage for the value
field.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Structures
typedef struct {
unsigned char *value; /* same as Property routines */
Atom encoding; /* prop type */
int format; /* prop data format: 8, 16, or 32 */
unsigned long nitems; /* number of data items in value */
} XTextProperty;
See AlsoXSetTextProperty(), XGetTextProperty(), XTextPropertyToStringList(),
XFreeStringList().
Xlib - Window Manager Hints XStringListToTextProperty()
