XmStringTableToXmString(library call)
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)
