


XmStringNCopy(3X)					    XmStringNCopy(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSttrriinnggNNCCooppyy	- A compound string function that creates a copy of a com-
  pound	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oppyy ((_s_1, _n_u_m__b_y_t_e_s))
       XXmmSSttrriinngg	 _s_1;;
       iinntt	 _n_u_m__b_y_t_e_s;;

DESCRIPTION
  XXmmSSttrriinnggNNCCooppyy	creates	a copy of _s_1 that contains a specified number of
  bytes, 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.

  _n_u_m__b_y_t_e_s
	 Specifies the number of bytes of _s_1 to	copy.  If this value is	less
	 than the length of _s_1,	as many	bytes as possible, but possibly	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)).

























