Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

X11R7.4 - man page for xtextproperty (x11r4 section 3)

XStringListToTextProperty(3)			    XLIB FUNCTIONS			 XStringListToTextProperty(3)

NAME
XStringListToTextProperty, XTextPropertyToStringList, XFreeStringList, XTextProperty - convert string lists and text property structure
SYNTAX
Status XStringListToTextProperty(char **list, int count, XTextProperty *text_prop_return); Status XTextPropertyToStringList(XTextProperty *text_prop, char ***list_return, int *count_return); void XFreeStringList(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 XTextProperty structure to be used. text_prop_return Returns the XTextProperty structure.
DESCRIPTION
The XStringListToTextProperty function sets the specified XTextProperty to be of type STRING (format 8) with a value representing the concatenation of the specified list of null-separated character strings. An extra null byte (which is not included in the nitems member) is stored at the end of the value field of text_prop_return. The strings are assumed (without verification) to be in the STRING encoding. If insufficient memory is avail- able for the new value string, XStringListToTextProperty does not set any fields in the XTextProperty struc- ture and returns a zero status. Otherwise, it returns a nonzero status. To free the storage for the value field, use XFree. The XTextPropertyToStringList function returns a list of strings representing the null-separated elements of the specified XTextProperty 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 NULL (encod- ing 0). The contents of the property are not null-terminated. If insufficient memory is available for the list and its elements, XTextPropertyToStringList sets no return values and returns a zero status. Otherwise, it returns a nonzero status. To free the storage for the list and its contents, use XFreeStringList. The XFreeStringList function releases memory allocated by XmbTextPropertyToTextList, Xutf8TextPropertyTo- TextList and XTextPropertyToStringList and the missing charset list allocated by XCreateFontSet.
STRUCTURES
The XTextProperty 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), XSetCom- mand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWin- dows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11) Xlib - C Language X Interface X Version 11 libX11 1.2.1 XStringListToTextProperty(3)


All times are GMT -4. The time now is 02:19 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password