XmStringConcatAndFree(library call) XmStringConcatAndFree(library call)
NAME [Toc] [Back]
XmStringConcatAndFree - A compound string function that appends one
string to another and frees the original strings
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmString XmStringConcatAndFree(
XmString s1,
XmString s2);
DESCRIPTION [Toc] [Back]
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 [Toc] [Back]
Returns a new compound string.
RELATED [Toc] [Back]
XmStringConcat(3), XmStringCreate(3), and XmStringFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
