Man Linux: Main Page and Category List

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)