XmStringTableParseStringArray()



     XmStringTableParseStringArUNIX3SXmStringTableParseStringArray(3X)



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

     SYNOPSIS
          #include <Xm/Xm.h>
          XmStringTable XmStringTableParseStringArray(
          XtPointer *strings,
          Cardinal count,
          XmStringTag tag,
          XmTextType type,
          XmParseTable parse,
          Cardinal parsecount,
          XtPointer calldata);

     VERSION
          This page documents Motif 2.1.

     DESCRIPTION
          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
                    typeindicates that a charset tag should be
                    created, then the tag will have the value of
                    XmFONTLISTDEFAULTTAG.  If typeindicates a locale
                    tag, then the tag will have the value of
                    XmFONTLISTDEFAULTTAG.

          type      Specifies the type of text to be passed in and the
                    type of tag. If the type is either
                    XmMULTIBYTETEXT or XmWIDECHARTEXT, a locale tag
                    should be created. If the type is XmCHARSETTEXT,
                    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.




     Page 1                                          (printed 1/22/99)



     XmStringTableParseStringArUNIX3SXmStringTableParseStringArray(3X)



          call_data Specifies data to be passed to the parse
                    procedures.

     RETURN
          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 XmStringFreecount times (that is, one time for each
          returned compound string) and then call XtFree to deallocate
          the XmStringTable itself.

     RELATED
          XmStringFree(3) and XmTabList(3).










































     Page 2                                          (printed 1/22/99)

Museum