Man Linux: Main Page and Category List

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)