1XmStringTableToXmString(library call) XmStringTableToXmString(library call)
2
3
4
6 XmStringTableToXmString — A convenience function that converts a com‐
7 pound string table to a single compound string
8
10 #include <Xm/Xm.h>
11 XmString XmStringTableToXmString(
12 XmStringTable table,
13 Cardinal count,
14 XmString break_component);
15
17 XmStringTableToXmString takes as input table of compound strings and a
18 specified string component (such as a tab) and returns a single com‐
19 pound string consisting of each of the elements of table concatenated
20 together with a single copy of break_component inserted between each
21 element.
22
23 table Specifies an XmStringTable containing the compound strings to
24 be converted.
25
26 count Specifies the number of compound strings in table.
27
28 break_component
29 Specifies the XmStringComponent that will be inserted in the
30 result to separate the individual elements of table. The most
31 useful types will be XmSTRING_COMPONENT_SEPARATOR and
32 XmSTRING_COMPONENT_TAB. Refer to the XmStringComponent‐
33 Type(3) reference page for a complete list of possible compo‐
34 nent types. Note, however, that the XmSTRING_COMPO‐
35 NENT_UNKNOWN component is not a possible type.
36
38 Returns a new XmString. The function will allocate space to hold the
39 returned compound string. When the application no longer needs the
40 returned compound string, the application should call XmStringFree.
41
43 XmString(3), XmStringComponentType(3), and XmStringFree(3).
44
45
46
47 XmStringTableToXmString(library call)