XmStringTableParseStringArray(libXrmaSrtyricnaglTla)bleParseStringArray(library call)




 NAME    [Toc]    [Back]
      XmStringTableParseStringArray - A convenience function that converts
      an array of strings to a compound string table

 SYNOPSIS    [Toc]    [Back]
      #include <Xm/Xm.h>
      XmStringTable XmStringTableParseStringArray(
      XtPointer *strings,
      Cardinal count,
      XmStringTag tag,
      XmTextType type,
      XmParseTable parse,
      Cardinal parse_count,
      XtPointer call_data);

 DESCRIPTION    [Toc]    [Back]
      XmStringTableParseStringArray takes an array of strings, allocates an
      XmStringTable with an equal number of slots, calls XmStringParseText
      on each string in strings, and inserts the resulting XmString in the
      corresponding slot in the XmStringTable.

      strings   Specifies an array of strings of characters as determined by
                type.

      count     Specifies the number of strings in strings.

      tag       Specifies the tag to be used in creating the result. The
                type of tag created (charset or locale) depends on the type
                of the text and the value given. If the value specified is
                NULL, and type indicates that a charset tag should be
                created, then the tag will have the value of
                XmFONTLIST_DEFAULT_TAG.  If type indicates a locale tag,
                then the tag will have the value of XmFONTLIST_DEFAULT_TAG.

      type      Specifies the type of text to be passed in and the type of
                tag. If the type is either XmMULTIBYTE_TEXT or
                XmWIDECHAR_TEXT, a locale tag should be created. If the type
                is XmCHARSET_TEXT, a charset tag will be created.

      parse     Specifies the parse table to be used.

      parse_count
                Specifies the number of entries in the parse table.

      call_data Specifies data to be passed to the parse procedures.

 RETURN    [Toc]    [Back]
      Returns a new XmStringTable.  The function allocates space to hold the
      XmStringTable.  When the application no longer needs the returned
      XmStringTable, the application should call XmStringFree count times
      (that is, one time for each returned compound string) and then call



                                    - 1 -       Formatted:  January 24, 2005






 XmStringTableParseStringArray(libXrmaSrtyricnaglTla)bleParseStringArray(library call)




      XtFree to deallocate the XmStringTable itself.

 RELATED    [Toc]    [Back]
      XmStringFree(3) and XmTabList(3).


                                    - 2 -       Formatted:  January 24, 2005