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 func-
tion, except that it frees the s1 and s2 strings, and is therefore more
efficient. You should use XmStringConcatAndFree instead of XmStringCon-
cat 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)
openMotif 2.3.1 - Generated Tue Dec 2 11:37:03 CST 2008