XmStringTableUnparse — A convenience function that converts a
table of compound strings to an array of text "XmStringTableUnparse"
#include <Xm/Xm.h>
XtPointer * XmStringTableUnparse(
XmStringTable table,
Cardinal count,
XmStringTag tag,
XmTextType tag_type,
XmTextType output_type,
XmParseTable parse,
Cardinal parse_count,
XmParseModel parse_model);
XmStringTableUnparse takes an array of compound strings, allocates a
string array for the type of characters determined by
type with an
equal number of slots, calls
XmStringUnparse on each compound string in
table, and inserts the resulting string in the corresponding slot in
the array.
- table
- Specifies an XmStringTable containing the compound
string to be converted.
- count
- Specifies the number of compound strings in
table.
- tag
- Specifies the tag to be used in matching with text
segments. The two types of tag types are XmFONTLIST_DEFAULT_TAG and
_MOTIF_DEFAULT_LOCALE. Only segments tagged with tag will be
returned. If tag is NULL, all segments will be matched.
- tag_type
- Specifies the type of tag to be searched for. These types
include XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and
XmCHARSET_TEXT.
- output_type
- Specifies the type of text to be generated. These types
include XmMULTIBYTE_TEXT, XmWIDECHAR_TEXT, and
XmCHARSET_TEXT.
- parse
- Specifies the parse table to be used.
- parse_count
- Specifies the number of items in parse.
- parse_model
- Specifies which non-text components to be considered in
matching in parse_table. Possible values are:
- XmOUTPUT_ALL
- Puts out all matching components.
- XmOUTPUT_BETWEEN
- Puts out only those matching components that are between
two matching text components.
- XmOUTPUT_BEGINNING
- Puts out only those matching components that are at the
beginning of a matching text component.
- XmOUTPUT_END
- Puts out only those matching components that are at the end
of a matching text component.
- XmOUTPUT_BOTH
- Puts out only those matching components that are at the
beginning or end of a matching text component.
Returns an allocated array of allocated strings. The application is responsible
for managing the allocated space. The application can recover the allocated
strings space by calling
XtFree count times (that is, one time
for each allocated string). The application can then recover the allocated
array by calling
XtFree on the allocated array itself.
XmStringTab.