ultrix man page for dwtcstrcat

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)