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

NAME

6       XmStringConcatAndFree  —  A  compound  string function that appends one
7       string to another and frees the original strings
8

SYNOPSIS

10       #include <Xm/Xm.h>
11       XmString XmStringConcatAndFree(
12       XmString s1,
13       XmString s2);
14

DESCRIPTION

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

RETURN

34       Returns a new compound string.
35
37       XmStringConcat(3), XmStringCreate(3), and XmStringFree(3).
38
39
40
41                                           XmStringConcatAndFree(library call)
Impressum