


XmStringNConcat(3X)					  XmStringNConcat(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSttrriinnggNNCCoonnccaatt - A compound string function that appends a specified
  number of bytes to a compound	string

SYNOPSIS


  ##iinncclluuddee <<XXmm//XXmm..hh>>
  XXmmSSttrriinngg XXmmSSttrriinnggNNCCoonnccaatt ((_s_1,	_s_2, _n_u_m__b_y_t_e_s))
       XXmmSSttrriinngg	 _s_1;;
       XXmmSSttrriinngg	 _s_2;;
       iinntt	 _n_u_m__b_y_t_e_s;;

DESCRIPTION
  XXmmSSttrriinnggNNCCoonnccaatt appends a specified number of	bytes from _s_2 to the end of
  _s_1, including	tags, directional indicators, and separators.  It then
  returns the resulting	compound string.  The original strings are preserved.
  The space for	the resulting compound string is allocated within the func-
  tion.	 The application is responsible	for managing the allocated space.
  The memory can be recovered by calling XXmmSSttrriinnggFFrreeee.

  _s_1	 Specifies the compound	string to which	a copy of _s_2 is	appended.

  _s_2	 Specifies the compound	string that is appended	to the end of _s_1.

  _n_u_m__b_y_t_e_s
	 Specifies the number of bytes of _s_2 to	append to _s_1.  If this value
	 is less than the length of _s_2,	as many	bytes as possible, but possi-
	 bly fewer than	this value, will be appended to	_s_1 such	that the
	 resulting string is still a valid compound string.

RETURN VALUE
  Returns a new	compound string.

RELATED	INFORMATION
  XXmmSSttrriinnggCCrreeaattee((33XX)) and XXmmSSttrriinnggFFrreeee((33XX)).






















