1XmStringComponentCreate(library call) XmStringComponentCreate(library call)
2
3
4
6 XmStringComponentCreate — A compound string function that creates arbi‐
7 trary components
8
10 #include <Xm/Xm.h>
11 XmString XmStringComponentCreate(
12 XmStringComponentType c_type,
13 unsigned int length,
14 XtPointer value);
15
17 XmStringComponentCreate creates a new XmString component of type
18 c_type, containing value. If value is invalid for the particular compo‐
19 nent type, this function fails and returns NULL.
20
21 c_type Specifies the type of component to be created.
22
23 length Specifies the length in bytes of value. Note that this must
24 be precisely the length of the value string, not including
25 any trailing null characters.
26
27 value Specifies the value to be used in the creation of the compo‐
28 nent.
29
30 Refer to the XmStringComponentType(3) reference page for a list of the
31 possible XmString component types.
32
34 If value is invalid for c_type, fails and returns NULL. Otherwise, this
35 function returns a new compound string. When the application no longer
36 needs the returned compound string, the application should call
37 XmStringFree.
38
40 XmString(3), XmStringGetNextTriple, XmStringComponentType, and
41 XmStringFree(3).
42
43
44
45 XmStringComponentCreate(library call)