NAME
XmStringTableToXmString — 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.
RELATED
XmString(3), XmStringComponentType(3), and XmStringFree(3).
XmStringTableToXmString(library call)