XmStringTableToXmString()



     XmStringTableToXmString(3XUNIX System XmStringTableToXmString(3X)



     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 breakcomponent);

     VERSION
          This page documents Motif 2.1.

     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
                    XmSTRINGCOMPONENTSEPARATOR and
                    XmSTRINGCOMPONENTTAB.  Refer to the
                    XmStringComponentType(3) reference page for a
                    complete list of possible component types. Note,
                    however, that the XmSTRINGCOMPONENTUNKNOWN
                    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).










     Page 1                                          (printed 1/22/99)
Museum
