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)
