XmStringConcatAndFree(3X)



     XmStringConcatAndFree(3X) UNIX System V XmStringConcatAndFree(3X)



     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);

     VERSION
          This page documents Motif 2.1.

     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).
















     Page 1                                          (printed 1/22/99)
Museum
