NAME

       XmStringConcatAndFree  —  A  compound  string  function  that appends one string to another and frees the
       original strings "XmStringConcatAndFree" "compound string functions" "XmStringConcatAndFree"

SYNOPSIS

       #include <Xm/Xm.h>
       XmString XmStringConcatAndFree(
       XmString s1,
       XmString s2);

DESCRIPTION

       XmStringConcatAndFree copies s2 to the end of s1 and returns a copy of the resulting compound string. The
       original strings are freed.  The function will allocate space to hold the returned compound string.   The
       application  is  responsible for managing the allocated space.  The application can recover the allocated
       space by calling XmStringFree.

       s1        Specifies the compound string to which a copy of s2 is appended

       s2        Specifies the compound string that is appended to the end of s1

       The XmStringConcatAndFree function works like the XmStringConcat function, except that it  frees  the  s1
       and  s2  strings,  and  is  therefore  more  efficient.  You  should use XmStringConcatAndFree instead of
       XmStringConcat if you want s1 and s2 to be freed afterwards.

RETURN

       Returns a new compound string.

RELATED

       XmStringConcat(3), XmStringCreate(3), and XmStringFree(3).

                                                                                        XmStringConcatAndFree(3)