1XmStringConcatAndFree(library call) XmStringConcatAndFree(library call)
2
3
4
6 XmStringConcatAndFree — A compound string function that appends one
7 string to another and frees the original strings
8
10 #include <Xm/Xm.h>
11 XmString XmStringConcatAndFree(
12 XmString s1,
13 XmString s2);
14
16 XmStringConcatAndFree copies s2 to the end of s1 and returns a copy of
17 the resulting compound string. The original strings are freed. The
18 function will allocate space to hold the returned compound string. The
19 application is responsible for managing the allocated space. The
20 application can recover the allocated space by calling XmStringFree.
21
22 s1 Specifies the compound string to which a copy of s2 is
23 appended
24
25 s2 Specifies the compound string that is appended to the end of
26 s1
27
28 The XmStringConcatAndFree function works like the XmStringConcat func‐
29 tion, except that it frees the s1 and s2 strings, and is therefore more
30 efficient. You should use XmStringConcatAndFree instead of XmStringCon‐
31 cat if you want s1 and s2 to be freed afterwards.
32
34 Returns a new compound string.
35
37 XmStringConcat(3), XmStringCreate(3), and XmStringFree(3).
38
39
40
41 XmStringConcatAndFree(library call)