1XmStringTableParseStringArray(librarXymSctarliln)gTableParseStringArray(library call)
2
3
4

NAME

6       XmStringTableParseStringArray — A convenience function that converts an
7       array of strings to a compound string table
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmStringTable XmStringTableParseStringArray(
12       XtPointer *strings,
13       Cardinal count,
14       XmStringTag tag,
15       XmTextType type,
16       XmParseTable parse,
17       Cardinal parse_count,
18       XtPointer call_data);
19

DESCRIPTION

21       XmStringTableParseStringArray takes an array of strings,  allocates  an
22       XmStringTable with an equal number of slots, calls XmStringParseText on
23       each string in strings, and inserts the resulting XmString in the  cor‐
24       responding slot in the XmStringTable.
25
26       strings   Specifies  an array of strings of characters as determined by
27                 type.
28
29       count     Specifies the number of strings in strings.
30
31       tag       Specifies the tag to be used in creating the result. The type
32                 of tag created (charset or locale) depends on the type of the
33                 text and the value given. If the value specified is NULL, and
34                 type indicates that a charset tag should be created, then the
35                 tag will have the value of XmFONTLIST_DEFAULT_TAG.   If  type
36                 indicates  a  locale tag, then the tag will have the value of
37                 XmFONTLIST_DEFAULT_TAG.
38
39       type      Specifies the type of text to be passed in and  the  type  of
40                 tag.    If   the   type   is   either   XmMULTIBYTE_TEXT   or
41                 XmWIDECHAR_TEXT, a locale tag should be created. If the  type
42                 is XmCHARSET_TEXT, a charset tag will be created.
43
44       parse     Specifies the parse table to be used.
45
46       parse_count
47                 Specifies the number of entries in the parse table.
48
49       call_data Specifies data to be passed to the parse procedures.
50

RETURN

52       Returns  a new XmStringTable.  The function allocates space to hold the
53       XmStringTable.  When the  application  no  longer  needs  the  returned
54       XmStringTable,  the  application  should  call XmStringFree count times
55       (that is, one time for each returned compound  string)  and  then  call
56       XtFree to deallocate the XmStringTable itself.
57

RELATED

59       XmStringFree(3) and XmTabList(3).
60
61
62
63                                   XmStringTableParseStringArray(library call)