XStringListToTextProperty(3) XLIB FUNCTIONS XStringListToTextProperty(3)

# [NAME](#NAME)

XStringListToTextProperty, XTextPropertyToStringList, XFreeStringList, XTextProperty - convert string lists and text property structure

# [SYNTAX](#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](#ARGUMENTS)

[*count*](#count)

Specifies the number of strings.

[*count\_return*](#count_return)

Returns the number of strings.

[*list*](#list)

Specifies the list of strings to be freed.

[*list*](#list~2)

Specifies a list of null-terminated character strings.

[*list\_return*](#list_return)

Returns a list of null-terminated character strings.

[*text\_prop*](#text_prop)

Specifies the **XTextProperty** structure to be used.

[*text\_prop\_return*](#text_prop_return)

Returns the **XTextProperty** structure.

# [DESCRIPTION](#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 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 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 (encoding 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**, **Xutf8TextPropertyToTextList** and **XTextPropertyToStringList** and the missing charset list allocated by **XCreateFontSet**.

# [STRUCTURES](#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](#SEE_ALSO)

[**XAllocClassHint**(3)](/man/os/libx11/XAllocClassHint.3), [**XAllocIconSize**(3)](/man/os/libx11/XAllocIconSize.3), [**XAllocSizeHints**(3)](/man/os/libx11/XAllocSizeHints.3), [**XAllocWMHints**(3)](/man/os/libx11/XAllocWMHints.3), [**XFree**(3)](/man/os/libx11/XFree.3), [**XSetCommand**(3)](/man/os/libx11/XSetCommand.3), [**XSetTransientForHint**(3)](/man/os/libx11/XSetTransientForHint.3), [**XSetTextProperty**(3)](/man/os/libx11/XSetTextProperty.3), [**XSetWMClientMachine**(3)](/man/os/libx11/XSetWMClientMachine.3), [**XSetWMColormapWindows**(3)](/man/os/libx11/XSetWMColormapWindows.3), [**XSetWMIconName**(3)](/man/os/libx11/XSetWMIconName.3), [**XSetWMName**(3)](/man/os/libx11/XSetWMName.3), [**XSetWMProperties**(3)](/man/os/libx11/XSetWMProperties.3), [**XSetWMProtocols**(3)](/man/os/libx11/XSetWMProtocols.3)  
*Xlib - C Language X Interface*

libX11 1.8.13 X Version 11

---

Document: XStringListToTextProperty(3) from libx11 1.8.13-r7 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libx11.git