manpagez: man pages & more
man XmStringTableParseStringArray(3)
Home | html | info | man

XmStringTableParseStringArray(library call)




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 parse_count,
       XtPointer call_data);


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  cor-
       responding 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

       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
       XtFree to deallocate the XmStringTable itself.


RELATED

       XmStringFree(3) and XmTabList(3).



                                   XmStringTableParseStringArray(library call)

openMotif 2.3.1 - Generated Wed Dec 3 16:55:06 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.