XmStringTableUnparse(3X)



     XmStringTableUnparse(3X)  UNIX System V  XmStringTableUnparse(3X)



     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 tagtype,
          XmTextType outputtype,
          XmParseTable parse,
          Cardinal parsecount,
          XmParseModel parsemodel);

     VERSION
          This page documents Motif 2.1.

     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
          XmStringUnparseon 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
                    XmFONTLISTDEFAULTTAG and MOTIFDEFAULTLOCALE.
                    Only segments tagged with tagwill 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 XmMULTIBYTETEXT,
                    XmWIDECHARTEXT, and XmCHARSETTEXT.

          output_type
                    Specifies the type of text to be generated. These
                    types include XmMULTIBYTETEXT, XmWIDECHARTEXT,
                    and XmCHARSETTEXT.

          parse     Specifies the parse table to be used.

          parse_count
                    Specifies the number of items in parse.

          parse_model



     Page 1                                          (printed 1/22/99)



     XmStringTableUnparse(3X)  UNIX System V  XmStringTableUnparse(3X)



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

                    XmOUTPUTALL
                              Puts out all matching components.

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

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

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

                    XmOUTPUTBOTH
                              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 XtFreecount 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.

















     Page 2                                          (printed 1/22/99)

Museum