dwtcstrcat(3dwt) [ultrix man page]

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)

DwtString(3Dwt) 														   DwtString(3Dwt)

Name
       DwtString - Creates a compound-string.

Syntax
       DwtCompString DwtString(text, charset, direction_r_to_l)
	    char *text;
	    unsigned long charset;
	    char direction_r_to_l;

Arguments
       text	 Specifies the text string to be converted to a compound-string.

       charset	 Specifies  the  character  set  for  the  compound-string.   Values  for  this  argument  can	be  found  in  the  required  file
		 /usr/include/cda_def.h.

       direction_r_to_l
		 Specifies the direction in which the text is drawn and wraps.	You can pass DwtDirectionLeftDown (text  is  drawn  from  left	to
		 right	and  wraps down); DwtDirectionRightUp (text is drawn from left to right and wraps up); DwtDirectionLeftDown (text is drawn
		 from right to left and wraps down); or DwtDirectionLeftUp (text is drawn from right to left and wraps up).

Description
       The DwtString function creates a compound-string from information in the argument list.	It has a simpler interface than the one  used  for
       DwtCSString.

       DwtString assumes the following default values:

       o    For language the default is DwtLanguageNotSpecified.

       o    For  rend  the default is DwtRendMaskNone.	The space for the resulting compound-string is allocated within the function.  After using
	    this function, you should free this space by calling XtFree.

Return Values
       This function returns the resulting compound-string.  However, it returns a NULL pointer if the text is NULL.

See Also
       DwtCSString(3Dwt), DwtLatin1String(3Dwt)
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

																   DwtString(3Dwt)