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_charsSpecifies the number of characters to be appended to the specified compound-string. If num_chars is less than the length of compound_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.