XmStringTableToXmString - Man Page

A convenience function that converts a compound string table to a single compound string

Synopsis

#include <Xm/Xm​.h>
XmString XmStringTableToXmString(
XmStringTable table,
Cardinal count,
XmString break_component);

Description

XmStringTableToXmString takes as input table of compound strings and a specified string component (such as a tab) and returns a single compound string consisting of each of the elements of table concatenated together with a single copy of break_component inserted between each element​.

table

Specifies an XmStringTable containing the compound strings to be converted​.

count

Specifies the number of compound strings in table​.

break_component

Specifies the XmStringComponent that will be inserted in the result to separate the individual elements of table​. The most useful types will be XmSTRING_COMPONENT_SEPARATOR and XmSTRING_COMPONENT_TAB​. Refer to the XmStringComponentType(3) reference page for a complete list of possible component types​. Note, however, that the XmSTRING_COMPONENT_UNKNOWN component is not a possible type​.

Return

Returns a new XmString​. The function will allocate space to hold the returned compound string​. When the application no longer needs the returned compound string, the application should call XmStringFree​.