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)