Man Linux: Main Page and Category List

NAME

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

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