redhat man page for xmstringconcatandfree

XmStringConcatAndFree(library call)									       XmStringConcatAndFree(library call)

NAME
       XmStringConcatAndFree -- A compound string function that appends one string to another and frees the original strings

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(library call)