1XmStringToXmStringTable(library call)    XmStringToXmStringTable(library call)
2
3
4

NAME

6       XmStringToXmStringTable — A convenience function that converts a single
7       compound string to a table of compound strings
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       Cardinal XmStringToXmStringTable(
12       XmString string,
13       XmString break_component,
14       XmStringTable *table);
15

DESCRIPTION

17       XmStringToXmStringTable takes as input a single compound string  and  a
18       specified  string component (such as a tab) and returns a table of com‐
19       pound strings consisting of portions of string delimited by  components
20       matching break_component. The components marking breaks will not appear
21       in the resulting table.
22
23       string    Specifies the XmString to be converted.
24
25       break_component
26                 Specifies the XmStringComponent that will be used to indicate
27                 where  to split string to form the individual elements of ta‐
28                 ble. The most useful types will be XmSTRING_COMPONENT_SEPARA‐
29                 TOR  and  XmSTRING_COMPONENT_TAB. Refer to the XmStringCompo‐
30                 nentType(3) reference page for a complete  list  of  possible
31                 component  types.  Note,  however,  that  the XmSTRING_COMPO‐
32                 NENT_UNKNOWN component is not a possible type.
33
34       table     Returns the  equivalent  XmStringTable.   The  function  will
35                 allocate  space to hold the returned XmStringTable.  When the
36                 applicaiton no longer needs the returned  XmStringTable,  the
37                 application  should  call XmStringFree once for each compound
38                 string in the table, and then calling  XtFree  to  deallocate
39                 the XmStringTable itself.
40

RETURN

42       Returns the number of compound strings in table.
43

45       XmStringTable(3).
46
47
48
49                                         XmStringToXmStringTable(library call)
Impressum