xstringlisttotextproperty(3x11) [ultrix man page]
XStringListToTextProperty(3X11) MIT X11R4 XStringListToTextProperty(3X11) Name XStringListToTextProperty, XTextPropertyToStringList, XFreeStringList, XTextProperty - convert string lists and text property structure Syntax Status XStringListToTextProperty(list, count, text_prop_return) char **list; int count; XTextProperty *text_prop_return; Status XTextPropertyToStringList(text_prop, list_return, count_return) XTextProperty *text_prop; char ***list_return; int *count_return; void XFreeStringList(list) char **list; Arguments count Specifies the number of strings. count_return Returns the number of strings. list Specifies the list of strings to be freed. list Specifies a list of null-terminated character strings. list_return Returns a list of null-terminated character strings. text_prop Specifies the structure to be used. text_prop_return Returns the structure. Description The function sets the specified to be 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_return. If insufficient memory is available for the new value string, does not set any fields in the structure and returns a zero status. Otherwise, it returns a non-zero status. To free the storage for the value field, use The function returns a list of strings representing the null-separated elements of the specified structure. The data in text_prop must be of type STRING and format 8. Multiple elements of the property (for example, the strings in a disjoint text selection) are separated by a NULL (encoding 0). The contents of the property are not null-terminated. If insufficient memory is available for the list and its ele- ments, sets no return values and returns a zero status. Otherwise, it returns a non-zero status. To free the storage for the list and its contents, use The function releases memory allocated by Structures The structure contains: typedef struct { unsigned char *value; /* property data */ Atom encoding; /* type of property */ int format; /* 8, 16, or 32 */ unsigned long nitems; /* number of items in value */ } XTextProperty; See Also XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransient- ForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11) X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys XStringListToTextProperty(3X11)
Check Out this Related Man Page
XStringListToTextProperty(3X11) MIT X11R4 XStringListToTextProperty(3X11) Name XStringListToTextProperty, XTextPropertyToStringList, XFreeStringList, XTextProperty - convert string lists and text property structure Syntax Status XStringListToTextProperty(list, count, text_prop_return) char **list; int count; XTextProperty *text_prop_return; Status XTextPropertyToStringList(text_prop, list_return, count_return) XTextProperty *text_prop; char ***list_return; int *count_return; void XFreeStringList(list) char **list; Arguments count Specifies the number of strings. count_return Returns the number of strings. list Specifies the list of strings to be freed. list Specifies a list of null-terminated character strings. list_return Returns a list of null-terminated character strings. text_prop Specifies the structure to be used. text_prop_return Returns the structure. Description The function sets the specified to be 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_return. If insufficient memory is available for the new value string, does not set any fields in the structure and returns a zero status. Otherwise, it returns a non-zero status. To free the storage for the value field, use The function returns a list of strings representing the null-separated elements of the specified structure. The data in text_prop must be of type STRING and format 8. Multiple elements of the property (for example, the strings in a disjoint text selection) are separated by a NULL (encoding 0). The contents of the property are not null-terminated. If insufficient memory is available for the list and its ele- ments, sets no return values and returns a zero status. Otherwise, it returns a non-zero status. To free the storage for the list and its contents, use The function releases memory allocated by Structures The structure contains: typedef struct { unsigned char *value; /* property data */ Atom encoding; /* type of property */ int format; /* 8, 16, or 32 */ unsigned long nitems; /* number of items in value */ } XTextProperty; See Also XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransient- ForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11) X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys XStringListToTextProperty(3X11)