DwtCStrcat(3Dwt) DwtCStrcat(3Dwt)
Name
DwtCStrcat, DwtCStrncat - Appends a copy of a compound-string to the end of another compound-string.
Syntax
DwtCompString DwtCStrcat(compound_string1,
compound_string2)
DwtCompString compound_string1, compound_string2;
DwtCompString DwtCStrncat(compound_string1,
compound_string2,
num_chars)
DwtCompString compound_string1, compound_string2;
int num_chars;
Arguments
compound_string1
Specifies a compound-string to which a copy of compound_string2 is appended.
compound_string2
Specifies a compound-string that is appended to the end of compound_string1.
num_chars Specifies the number of characters to be appended to the specified compound-string. If num_chars is less than the length of com-
pound_string2, the resulting string will not be a valid compound-string.
Description
The DwtCStrcat function appends compound_string2 to the end of compound_string1 and returns the resulting string. The original strings are
preserved. The space for the resulting compound-string is allocated within the function. After using this function, you should free this
space by calling XtFree.
The DwtCStrncat function appends no more than the number of characters specified in num_chars, which includes tag and length sections of
the compound-string.
Return Values
These functions return a pointer to the resulting compound-string.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtCStrcat(3Dwt)
