NAME

       XmStringTableToXmString  —  A  convenience  function  that  converts  a compound string table to a single
       compound string "XmStringTableToXmString"

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(3)