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 parse_count,
XtPointer call_data);
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
XmFONTLIST_DEFAULT_TAG. If typeindicates 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.
Page 1 (printed 7/20/06)
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 7/20/06)