NAME

       XmStringTableUnparse  —  A  convenience function that converts a table of compound strings to an array of
       text "XmStringTableUnparse"

SYNOPSIS

       #include <Xm/Xm.h>
       XtPointer * XmStringTableUnparse(
       XmStringTable table,
       Cardinal count,
       XmStringTag tag,
       XmTextType tag_type,
       XmTextType output_type,
       XmParseTable parse,
       Cardinal parse_count,
       XmParseModel parse_model);

DESCRIPTION

       XmStringTableUnparse takes an array of compound strings,  allocates  a  string  array  for  the  type  of
       characters  determined  by  type  with  an  equal number of slots, calls XmStringUnparse on each compound
       string in table, and inserts the resulting string in the corresponding slot in the array.

       table     Specifies an XmStringTable containing the compound string to be converted.

       count     Specifies the number of compound strings in table.

       tag       Specifies the tag to be used in matching with text segments.  The two types of  tag  types  are
                 XmFONTLIST_DEFAULT_TAG  and  _MOTIF_DEFAULT_LOCALE.   Only  segments  tagged  with  tag will be
                 returned. If tag is NULL, all segments will be matched.

       tag_type  Specifies  the  type  of  tag  to  be  searched  for.  These  types  include  XmMULTIBYTE_TEXT,
                 XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       output_type
                 Specifies   the   type   of  text  to  be  generated.  These  types  include  XmMULTIBYTE_TEXT,
                 XmWIDECHAR_TEXT, and XmCHARSET_TEXT.

       parse     Specifies the parse table to be used.

       parse_count
                 Specifies the number of items in parse.

       parse_model
                 Specifies which non-text components to be  considered  in  matching  in  parse_table.  Possible
                 values are:

                 XmOUTPUT_ALL
                           Puts out all matching components.

                 XmOUTPUT_BETWEEN
                           Puts  out  only  those  matching  components  that  are  between  two  matching  text
                           components.

                 XmOUTPUT_BEGINNING
                           Puts out only those matching components that are at the beginning of a matching  text
                           component.

                 XmOUTPUT_END
                           Puts  out  only  those  matching  components  that  are at the end of a matching text
                           component.

                 XmOUTPUT_BOTH
                           Puts out only those matching components that  are  at  the  beginning  or  end  of  a
                           matching text component.

RETURN

       Returns  an  allocated  array  of  allocated  strings.   The  application is responsible for managing the
       allocated space.  The application can recover the allocated strings space by calling XtFree  count  times
       (that  is,  one time for each allocated string).  The application can then recover the allocated array by
       calling XtFree on the allocated array itself.

RELATED

       XmStringTab.

                                                                                         XmStringTableUnparse(3)